> For the complete documentation index, see [llms.txt](https://docs.jmapcloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jmapcloud.io/en/jmap-ng/jmap-ng-user-guide/fonctions/creating-annotations-on-the-map.md).

# Creating Annotations on the Map

You can create annotations such as drawings or text on the map, which can be saved in PDF format along with the map.

## The Annotations Panel

The **Annotations** panel contains the drawing tools available in the application.

1. Click <img src="/files/Kp6jYfm4LV9AF5gFeBQt" alt="" data-size="line"> to open the **Annotations** panel. The icon changes color.

   <figure><img src="/files/73SrfyDey96Wch81NEq2" alt=""><figcaption></figcaption></figure>

   <table data-header-hidden><thead><tr><th width="50.203125" align="center" valign="top">#</th><th valign="top">Description</th></tr></thead><tbody><tr><td align="center" valign="top">1</td><td valign="top">Tools for creating different types of annotations.</td></tr><tr><td align="center" valign="top">2</td><td valign="top"><p><strong>Select</strong></p><p>Button to select annotations. <br><strong>Delete</strong></p><p>Button to delete annotations.</p></td></tr><tr><td align="center" valign="top">3</td><td valign="top"><p><strong>Fill</strong><br>Tools to select the fill color and transparency of polygon-type annotations. </p><p>The <a href="#fill">Fill</a> section provides details.</p></td></tr><tr><td align="center" valign="top">4</td><td valign="top"><p><strong>Line</strong></p><p>Tools to set the thickness, color, and transparency of lines. </p><p>The <a href="#line">Line</a> section provides details.</p></td></tr><tr><td align="center" valign="top">5</td><td valign="top"><p><strong>Text</strong></p><p>Tools to set the size, rotation, and color of text. </p><p>The <a href="#text">Text</a> section provides details.</p></td></tr><tr><td align="center" valign="top">6</td><td valign="top"><p><strong>Snap tool</strong></p><p>Check the box to activate it.</p></td></tr><tr><td align="center" valign="top">7</td><td valign="top"><p><strong>Available layers</strong></p><p>Layers available in the project to snap drawings to. Select the layer whose features will be used to snap drawings.</p></td></tr><tr><td align="center" valign="top">8</td><td valign="top">Help for creating annotations.</td></tr></tbody></table>
2. Click the tool of your choice to activate it. The [Drawing Tools](#drawing-tools) section details their characteristics and how to use them.
3. Create the desired drawings. You can switch tools to create other types of drawings. Drawings remain until you delete them.

## Drawing Tools

Several tools are available for creating annotations:

<table data-header-hidden><thead><tr><th width="58.8203125" align="center" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td align="center" valign="top"><img src="/files/NgjnZgrRSjIySyBPjwgt" alt="" data-size="line"></td><td valign="top"><p><strong>Point</strong></p><ol><li>Click <img src="/files/NgjnZgrRSjIySyBPjwgt" alt="" data-size="line"> to activate the tool.</li><li>Click at the desired location to draw a point.</li></ol><p>The appearance of a point is determined in the <a href="#fill">Fill</a> and <a href="#line">Line</a> sections. You can select the characteristics before drawing the points. You can also modify the appearance of one or more points after they are created.</p></td></tr><tr><td align="center" valign="top"><img src="/files/kPb7gMS9sUDkYHY5o8Ds" alt="" data-size="line"></td><td valign="top"><p><strong>Line</strong></p><ol><li>Click <img src="/files/kPb7gMS9sUDkYHY5o8Ds" alt="" data-size="line"> to activate the tool.</li><li>Click at the desired location to draw the first point of the line.</li><li>Click at another location to add a vertex to the line.</li><li>When you have drawn the line, double-click to finish it.</li></ol><p>The appearance is determined in the <a href="#line">Line</a> section. You can select the characteristics before drawing the line. You can also modify the appearance of one or more lines after they are created.</p></td></tr><tr><td align="center" valign="top"><img src="/files/f40WRWAxglPJ2QQHGJBZ" alt="" data-size="line"></td><td valign="top"><p><strong>Circle</strong></p><ol><li>Click <img src="/files/f40WRWAxglPJ2QQHGJBZ" alt="" data-size="line"> to activate the tool.</li><li>Click at the desired location to draw the center of the circle.</li><li>Drag the cursor to draw the circle.</li><li>Click to finish the circle.</li></ol><p>The appearance of the circle is determined in the <a href="#fill">Fill</a> and <a href="#line">Line</a> sections. You can select the characteristics before drawing the circle. You can also modify the appearance of one or more circles after they are created.</p></td></tr><tr><td align="center" valign="top"><img src="/files/IUaXv0tNkWTVRWRZoPM7" alt="" data-size="line"></td><td valign="top"><p><strong>Rectangle</strong></p><ol><li>Click <img src="/files/IUaXv0tNkWTVRWRZoPM7" alt="" data-size="line"> to activate the tool.</li><li>Click at the desired location to draw the first vertex of the rectangle.</li><li>Drag the cursor to draw the rectangle.</li><li>Click to draw the opposite vertex and finish the rectangle.</li></ol><p>The appearance of the rectangle is determined in the <a href="#fill">Fill</a> and <a href="#line">Line</a> sections. You can select the characteristics before drawing the rectangle. You can also modify the appearance of one or more rectangles after they are created.</p></td></tr><tr><td align="center" valign="top"><img src="/files/RDiyx9LNxCrcGC3qUcy3" alt="" data-size="line"></td><td valign="top"><p><strong>Polygon</strong></p><ol><li>Click <img src="/files/RDiyx9LNxCrcGC3qUcy3" alt="" data-size="line"> to activate the tool.</li><li>Click at the desired location to draw the first vertex of the polygon.</li><li>Click to draw the polygon vertices.</li><li>Double-click to draw the last vertex and finish the polygon.</li></ol><p>The appearance of the polygon is determined in the <a href="#fill">Fill</a> and <a href="#line">Line</a> sections. You can select the characteristics before drawing the polygon. You can also modify the appearance of one or more polygons after they are created.</p></td></tr><tr><td align="center" valign="top"><img src="/files/JMfYLI20S0HD4KuwulhD" alt="" data-size="line"></td><td valign="top"><p><strong>Text</strong></p><ol><li>Click <img src="/files/JMfYLI20S0HD4KuwulhD" alt="" data-size="line"> to activate the tool.</li><li>Click at the desired location to place the text. The text input interface opens.</li><li>Enter the text.</li><li>Click <strong>OK</strong> to save the text or <strong>Cancel</strong> to close the interface without saving.</li></ol><p>The appearance of the text is determined in the <a href="#text">Text</a> section. You can select the characteristics before writing the text. You can also modify the appearance of one or more text annotations after they are created.</p></td></tr></tbody></table>

## Annotation Style

### Fill

This section defines the fill color and transparency for points, circles, rectangles, and polygons.

<figure><img src="/files/y0Phdem9SHx2cb3YMiSr" alt="" width="285"><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="50.08203125" align="center" valign="top">#</th><th valign="top">Description</th></tr></thead><tbody><tr><td align="center" valign="top">1</td><td valign="top"><p><strong>Color swatch</strong></p><p>Displays the selected color with its transparency level. </p><p>Click the swatch to open the fill color selection tool. </p><p>This tool allows you to define the color in several ways.</p></td></tr><tr><td align="center" valign="top">2</td><td valign="top"><p><strong>Visual tools</strong></p><p>Visual tools for selecting the color. </p><p>Select the color in the color bar by dragging the slider. </p><p>Select the shade in the color field by dragging the point. </p><p>The selected color is displayed in the Hex, RGB fields and in the color swatch.</p></td></tr><tr><td align="center" valign="top">3</td><td valign="top"><p><strong>Hexadecimal code (Hex)</strong></p><p>Hexadecimal code of the selected color. </p><p>Enter the hexadecimal code in the Hex field. </p><p>The entered color is displayed in the swatch, the color bar, the color field, and the RGB indicators. </p><p>The hexadecimal code is always displayed in the Fill section.</p></td></tr><tr><td align="center" valign="top">4</td><td valign="top"><p><strong>RGB code</strong></p><p>The color can also be defined using the RGB code. </p><p>Enter the R, G, and B values of the desired color. </p><p>All color indicators display the selected color.</p></td></tr><tr><td align="center" valign="top">5</td><td valign="top"><p><strong>Opacity level</strong></p><p>Opacity level of the fill. </p><p>Select the fill opacity level in the second bar by dragging the slider. Maximum opacity is on the right and maximum transparency is on the left. You can also enter the value directly in the A field. </p><p>The opacity percentage is always displayed in the Fill section.</p></td></tr><tr><td align="center" valign="top">6</td><td valign="top"><p><strong>History</strong></p><p>The most recently selected colors are kept in memory.</p></td></tr></tbody></table>

### Line

This section defines the appearance of lines for linear drawings as well as the outlines of circles, polygons, rectangles, and points.

<figure><img src="/files/ZMBg1dnChb9MkjqnQWXM" alt="" width="296"><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="51.98828125" align="center" valign="top">#</th><th valign="top">Description</th></tr></thead><tbody><tr><td align="center" valign="top">1</td><td valign="top"><p><strong>Thickness</strong></p><p>To define the line thickness, select the value from the dropdown list.</p></td></tr><tr><td align="center" valign="top">2</td><td valign="top"><p><strong>Color swatch</strong></p><p>Displays the selected line color with its transparency level. </p><p>Click the swatch to open the line color selection tool.</p></td></tr><tr><td align="center" valign="top">3</td><td valign="top"><p><strong>Visual tools</strong></p><p>Visual tools for selecting the color. </p><p>Select the color in the color bar by dragging the slider. </p><p>Select the shade in the color field by dragging the point. </p><p>The selected color is displayed in the Hex, RGB fields and in the color swatch.</p></td></tr><tr><td align="center" valign="top">4</td><td valign="top"><p><strong>Hexadecimal code (Hex)</strong></p><p>Enter the hexadecimal code in the Hex field. </p><p>The entered color is displayed in the swatch, the color bar, the color field, and the RGB indicators. </p><p>The hexadecimal code is always displayed in the Line section.</p></td></tr><tr><td align="center" valign="top">5</td><td valign="top"><p><strong>RGB code</strong></p><p>Enter the R, G, and B values of the desired color. </p><p>All color indicators display the selected color.</p></td></tr><tr><td align="center" valign="top">6</td><td valign="top"><p><strong>Opacity level</strong></p><p>Opacity level of the line. </p><p>Select the line opacity level in the second bar by dragging the slider. Maximum opacity is on the right and maximum transparency is on the left. You can also enter the value directly in the A field. </p><p>The opacity percentage is always displayed in the Line section.</p></td></tr><tr><td align="center" valign="top">7</td><td valign="top"><p><strong>History</strong></p><p>The most recently selected colors are kept in memory.</p></td></tr></tbody></table>

### Text

This section defines the appearance of text annotations.

<figure><img src="/files/VCa7v3fbddv1WSY6FCY5" alt="" width="309"><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="49.71484375" align="center" valign="top">#</th><th valign="top">Description</th></tr></thead><tbody><tr><td align="center" valign="top">1</td><td valign="top"><p><strong>Size</strong></p><p>To define the font size, select the value from the dropdown list.</p></td></tr><tr><td align="center" valign="top">2</td><td valign="top"><p><strong>Rotation</strong></p><p>Enter the rotation angle to apply to the text.</p></td></tr><tr><td align="center" valign="top">3</td><td valign="top"><p><strong>Color swatch</strong></p><p>Displays the selected text color. </p><p>Click the swatch to open the text color selection tool.</p></td></tr><tr><td align="center" valign="top">4</td><td valign="top"><p><strong>Visual tools</strong></p><p>Visual tools for selecting the color. </p><p>Select the color in the color bar by dragging the slider. </p><p>Select the shade in the color field by dragging the point. </p><p>The selected color is displayed in the Hex, RGB fields and in the color swatch.</p></td></tr><tr><td align="center" valign="top">5</td><td valign="top"><p><strong>Hexadecimal code (Hex)</strong></p><p>Enter the hexadecimal code in the Hex field. </p><p>The entered color is displayed in the swatch, the color bar, the color field, and the RGB indicators. </p><p>The hexadecimal code is always displayed in the Text section.</p></td></tr><tr><td align="center" valign="top">6</td><td valign="top"><p><strong>RGB code</strong></p><p>Enter the R, G, and B values of the desired color. </p><p>All color indicators display the selected color.</p></td></tr><tr><td align="center" valign="top">7</td><td valign="top"><p><strong>History</strong></p><p>The most recently selected colors are kept in memory.</p></td></tr></tbody></table>

## Modifying Annotations

You can modify drawings. You can modify the shape of one drawing at a time. You can modify the appearance, location, apply rotation, or delete multiple drawings simultaneously.

### Modifying the Appearance of Drawings or Text

1. Click **Select** to select the drawings or text to modify.
2. Click on a text or drawing to select it. The drawing's lines change appearance and the text stroke becomes bold, indicating the annotation is selected.
3. Hold down SHIFT and click on another text or drawing to add it to the selection. You can select multiple texts or multiple drawings (circles, points, rectangles, or polygons). You cannot select text and drawings together.
4. Depending on the type of annotation in your selection, use the **Fill**, **Line**, and **Text** tools to modify the appearance of the annotations. The changes are visible on the map.
5. Click on another annotation or on the map to deselect the annotations.

### Modifying the Shape of a Drawing

1. Click **Select** to select the drawings to modify.
2. Click on a drawing to select it. The drawing's vertices are displayed.
3. Click on a vertex to select it. It turns black. New vertices colored orange appear between the original vertices.
4. Drag the selected vertex to the desired position. The drawing changes accordingly.
5. Make modifications by selecting the vertices to work with.
6. Click on another annotation or on the map to deselect the annotation.

<figure><img src="/files/Z95UTppfX365URP7braR" alt=""><figcaption></figcaption></figure>

### Modifying the Location of Annotations

You can modify the location of annotations. You can move one text at a time, but you can move multiple drawings together.

#### Moving a text

1. Click **Select** to select the text to move.
2. Click on a text to select it. The text stroke becomes bold, indicating the text is selected.
3. Using the hand-shaped cursor, grab the text and drag it to the desired position.
4. Drop the text there.
5. Click on another annotation or on the map to deselect the text.

#### Moving drawings

1. Click **Select** to select the drawings to move.
2. Click a drawing to select it. The drawing's lines change appearance, indicating it is selected.
3. Hold down SHIFT and click another drawing to add it to the selection.
4. Using the hand-shaped cursor when hovering over one of the drawings, drag the drawings to the desired position.
5. Drop the drawings there.
6. Click another annotation or the map to deselect the drawings.

<figure><img src="/files/vRGv5HStumacwhPbDfIX" alt=""><figcaption></figcaption></figure>

### Rotating Annotations

You can apply rotation to a selection of drawings or a selection of text. You cannot apply rotation to a mixed selection of drawings and text.

1. Click **Select** to select the drawings or text to rotate.
2. Click a drawing or text to select it. The drawing's lines or text appearance change, indicating it is selected. The **Rotate (1)** button appears, indicating one element to rotate.
3. Hold down SHIFT and click on another drawing/text to add it to the selection. The **Rotate()** button displays in parentheses the number of selected elements.
4. Click **Rotate**. An interface opens allowing you to enter the rotation angle (between -360° and +360°) to apply to the selected drawings/text.
5. Click **OK**. The drawings/text are displayed with the applied rotation.

<figure><img src="/files/EeXI2ef1NObJ2Cb7kgfV" alt=""><figcaption></figcaption></figure>

### Deleting Annotations

1. Click **Select** to select the drawings or text to delete.
2. Click a text or drawing to select it. The drawing's lines change appearance and the text stroke becomes bold, indicating the annotation is selected.
3. Hold down SHIFT and click on another text or drawing to add it to the selection. You can select multiple texts or multiple drawings (circles, points, rectangles, or polygons). You cannot select text and drawings together. The **Delete** button indicates the number of selected annotations.
4. Click **Delete** to erase the selected annotations.
