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 as a base64 encoded image. FX-PML re-encodes imported images as jpeg for compact project files. ## Calibrate (Scale) 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. ![[Canvas-Toolbar.png]] The **Refresh** tool will update the canvas after the user makes changes to the model objects. For example, changing the color or width of an Area Asset. Usually changing any property will automatically trigger a refresh so the Refresh tool should not be required in most cases. The **Measure Distance** tool lets you click and drag a line and read the distance. The **Pick Query** tool is used to inspect objects at a canvas location. ![[Pick-Query.png]] ## 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.