> For the complete documentation index, see [llms.txt](https://horus-make-sense.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://horus-make-sense.gitbook.io/documentation/software/geosuite/movie-player/layer-edit-module.md).
# Layer Edit Module
The Layer Edit module allows you to perform measurements, add shapes and annotations to an editable layer. This chapter describes the functions of the Layer Edit module.
## 1. Accessing the Layer Edit Module
The Layer Edit module is activated with the Layer edit button. When the Layer Edit module is activated, the edit buttons will appear in the toolbar:\
\
\
| From Left to Right |
| ------------------ |
| Open |
| Save |
| Add Point |
| Add Line |
| Add Multiline |
| Add Polygon |
| Add Height Line |
| Delete Geometry |
| Export |
## 2. Geometries
The Layer edit module allows you to annotate points and objects in the images by creating a geometry. These geometries are linked to the GPS coordinates and they are projected on the image in the main screen. This means that the GPS information is leading for the exact size and shape of geometries, not the image data.
In the Horus Movie Player, there are two methods of creating geometries, there are single-click and multi-click measurements.\
**Single-Click**: Quicker to annotate points and objects. Good accuracy on the frame that is was created, but there might be some shift in position on other frames. Can only measure on the ground plane.\
**Multi-Click**: Slower to create. Used when you wish to measure points and objects not on the ground plane. Less shift when viewed from different frames. More on Multi-Click measurements in chapter [4.](#id-4.-multi-click-measurements)
When creating a geometry, it is important to maintain the highest possible accuracy. This is determined – as stated – by the GPS coordinates. The accuracy for (possible) measurements is indicated by the color of the cursor in the main screen. The accuracy decreases when the cursor is moved away from the recording position. The color of the cursor will change to orange and red to indicate a decreased accuracy:\
### 2.1 Estimating Measurements
The cursor can be used as a reference object to estimate measurements and angles of objects in the main screen. By pressing the Shift button and using the scroll wheel on the mouse, the cursor will project a circle of the desired diameter on ground level:\
\
\
By pressing the Alt key and using the scroll wheel on the mouse, the cursor will project a mast of the desired height:\
\
\
By pressing the Shift and Alt key and scrolling the mouse wheel, a cone will be projected in the main screen. This can be used to estimate the angle of objects in the main screen:\
### 2.2 Adding a Point
You can add a so called ‘point’ to any location in the image. Points are used to indicate areas or objects of interest and can be accompanied by an annotation on a form. A point will be placed on ground level in the annotations layer (see [2.1](#id-2.1-estimating-measurements))
To add a point to the image, click the Add point button:\
\
\
A small crosshair will appear with the cursor in the main screen, this indicates that the ‘Add point’ function is active:\
\
\
By clicking the left mouse button a point is added to the image and geometry. The point is shown in both the map screen and the main screen:\
\
\
A point can be moved by clicking the left-clicking and holding the Shift button.
### 2.3 Changing the Icon for a Point
The icon that is used to indicate a point can be changed. This is described in [paragraph 1.9](https://horus-make-sense.gitbook.io/documentation/software/geosuite/movie-player/pages/oP4Kp1kjL86imQyJt1tz#id-1.9-selecting-an-icon-for-points-in-a-label) of the Layer Manager Module page.
### 2.4 Adding a line (length measurement)
With the Add line button you can add lines to the image / geometry. This function can also be used to perform measurements on ground level. To add a line / perform a length measurement, click the Add line button:\
\
\
A small crosshair will appear with the cursor in the main screen, this indicates that the ‘Add line’ function is active. To draw a line, left click on the point where you want to start the line, pull the line to its end point and left click again. The length of the line is shown on ground level:
### 2.5 Adding a Multiline
A multiline is used to measure non-straight lines. Click the Add multiline button to draw a multiline:\
\
\
A small crosshair will appear with the cursor in the main screen, this indicates that the ‘Add multiline’ function is active. To draw a line, left click on the point where you want to start the line, pull the line to a between point and left click. You can add as much ‘in between points’ as needed. To end the multiline, right click. The length of the multiline is shown on ground level:
Whilst creating a multiline measurement you can move between frames with the arrow keys.\
For the best results, ensure that the points are made close to the vehicle.
### 2.6 Adding a Polygon
The polygon is used to annotate areas on ground level, the Layer Edit module calculates the surface area immediately.
Click the Add polygon button to draw a polygon:\
\
\
A polygon is defined by its edges, by left clicking, the edges are placed in the image / geometry. To define the final edge of the polygon, right click. The Layer Edit module immediately calculates the surface area of the polygon:
Depending on the layer settings (see [2.1](https://horus-make-sense.gitbook.io/documentation/software/geosuite/movie-player/pages/oP4Kp1kjL86imQyJt1tz#id-2.1-creating-a-new-form) of the Layer manager Module page) a form can be attached to the polygon (or other shapes that you draw). In this form you can add additional information about the shape / form.
### 2.7 Adding a Height Line
Height lines are used to measure / indicate heights of objects in the images. For height measurement it is important to be as close to the object as possible. To draw a height line, click the Add height line button:\
\
\
Move as close to the object you want to measure and place the start point of the height line on ground level by left clicking. Pull the line upwards to the top of the object and right click to define the end point of the height line:
### 2.8 Deleting a Geometry
To delete a geometry, select the geometry by left clicking it. The index finger symbol in the cursor indicates that an object is selectable. A selected object is marked with a red outline:
To delete the selected geometry, click the Delete geometry button:\
\
\
The Delete geometry button is not shown when no geometry is selected. The Layer Edit module will ask for confirmation to delete the geometry / annotation. Click OK to confirm.\
Alternatively, you can delete the geometry by pressing the Delete button on your keyboard.
### 2.9 Clone Geometries
A geometry can be cloned with the Clone geometry button:\
\
\
To clone a geometry, select the geometry in the main screen and click the Clone geometry button. The Layer Edit module will place a clone over the existing geometry. The cloned geometry may not seem visible, but when you select and move the geometry, the original geometry will remain on its position whilst the clone can be re-positioned.
## 4. Multi-Click Measurements
The multi click measurement function is used to measure surface areas that are not on ground level. The multi click measurement is performed by defining the corners (points) from different recording locations. The Movie Player can calculate the surface area using the spatial data and GPS info. \
\
To perform a multi click measurement, click the Multi click measurement button:\
\
\
The multi click measurement menu will appear in the bottom of the screen:
In this example the surface area of the large window in the main screen (indicated with the blue rectangle) will be measured.\
\
The multi click measurement can be performed by two methods: the 3-click and 5-click method. \
The 3-click method uses the spatial data from 3 frames, the 5-click method uses the data from 5 frames and is the most accurate. \
For the measurement of the window in this example, the 3-click method is sufficient, therefore, the 3-Click method is selected (1). After that, you need to specify the number of points you need for the measurement. In this case (a rectangular shape) four points are needed (2):
To start the measurement, click the Start button. \
When the multi click measurement is started, the following warning appears:\
\
\
To start the multi click measurement, click on the corners of the shape while holding the Shift key. The points (or edges of the rectangle) will appear in the boxes of the Status field:
After the first set of points is selected, the multi click measurement shows this screen, a warning to proceed to the next frame. Click OK to continue:\
\
\
To move to the next frame, click the Next frame button in the player controls and select the points of the shape from the recording position of this frame. \
**Select the points in the same order as in the previous frame!**\
\
After all points have been selected in the consecutive frames, the multi click measurement will confirm this with the following message. Click OK to continue:\
\
\
The Calculate button will appear in the bottom right corner of the multi click measurement screen. Click this button to calculate the surface area:
The surface area that is calculated is shown in the main screen:\
\
\
The geometry that is projected on the image, will ‘stick’ to the object in the image. The annotation will be visible from other recording positions:\
