# Maps and Canvas Maps are raster images used as a visual and coordinate reference for the model. The canvas overlays assets, sources, labels, and results on top of the calibrated map. ## Add a Raster Image 1. Open the **Data** tab. 2. Right-click **Maps**. 3. Choose **Add Raster Image**. 4. Select an image file. Imported raster images are stored inside the `.fxpml` project. FX-PML re-encodes imported images for compact project files. ## Calibrate the Map Select the raster image and set these properties: ![[Images/Raster-Image-PropertyGrid.png]] - **Known Pixel**: a known pixel coordinate in the image. - **Known Point**: the real-world coordinate, in feet, for the known pixel. - **Scale Start**: the start pixel for a known-distance line. - **Scale End**: the end pixel for the known-distance line. - **Scale Distance**: the real-world distance between the scale start and scale end, in feet. Use the ellipsis button on pixel fields to pick directly from the image. Use the ellipsis button on point fields to pick directly from the canvas. ![[Images/Pixel-Picker.png]] ## Canvas Navigation Use the canvas toolbar to refresh, zoom in, zoom out, or zoom all. The status bar reports cursor coordinates in world units. The **Measure Distance** tool lets you click two points and read the distance. The **Pick Query** tool is available after results exist and is used to inspect result values at a canvas location. ## Display Settings The **Settings** tab controls canvas display options: - **Grid Spacing** draws a background grid when greater than zero. - **Show IDs** toggles asset and source ID labels. - **ID Font Size** controls label size. - **Snap Angle** helps geometry picking snap nearly horizontal or vertical edges. ## Export the Canvas Use **File > Screen to File** to save the current canvas view to an image. Use **File > Screen to Clipboard** to copy the current view for pasting into another document.