Updated Scale and distance (markdown)

Scale-and-distance.md

@@ -15,8 +15,9 @@ In the icons at the bottom of the Units editor are more options:
 * Curve ruler, opisometer
 * Route opisometer
 * Planimeter
-* Remove all rulers
-* Restore default unit settings
+* Remove all rulers. A popup appears that reads: Are you sure you want to remove all placed rulers?
+If you just want to hide rulers, toggle the Rulers layer off in Menu. And buttons remove and cancel.
+* Restore default unit settings. Set values to default but don't remove rulers.
 
 ### Distance
 
@@ -76,12 +77,85 @@ Here you can change the amount of people and population ratio live in the map.
 * Urbanization rate. Burg population relative to all population. This does not modify the total population or decrease rural population. It only increases the people at burgs and makes the percentage of people living at burgs higher. By default: 1. Min: 0.01. Max: 5.
 * Urban density. Average people per building in medieval fantasy city generator. By default: 10. Min: 1. Max: 200.
 
-Work in progress. 
-
 ## Rulers
 
+Click on a ruler to delete it or the button with a bin to remove all rulers.
+
+### Linear rulers.
+When you click on the ruler icon a new linear ruler is created in the middle of the screen.
+
+* Drag the whole ruler clicking on the label and holding.
+* Extend the ruler clicking on the dot at one of the two ends of the ruler. Hold the mouse button to extend and move the mouse to control the direction.
+* Click anywhere inside the ruler to create a ruler anchor point. A circle appears at that anchor point to indicate it. Even if you move the ruler at the edges, it will remain fixed at the anchor point. This allows you to measure contours that are not straight. Click on the same point to delete that anchor point.
+* You can hold `CTRL` and drag the dot at one of the ends to keep the previous endpoint as an anchor point and extend the ruler.
+* Click on the endpoint to delete that and return to previous, shorter length of the ruler.
+* Click on an anchor point and hold `SHIFT` to move the anchor point only in horizontal or vertical of the origin point. This is called to "keep the axial direction".
+
+### Curve ruler, opisometer
+
+When you click the opisometer ruler you, your cursor changes to a cross. You need to click and hold on the origin of your ruler and draw the opisometer on the map.
+* Meanwhile your cursor is a cross, you can hold `SHIFT` to disallow path optimization.
+* Click and hold on the label or the line to drag the opisometer.
+* Click on the circle at the end to extend the opisometer.
+
+### Route opisometer
+When you click the opisometer ruler you, your cursor changes to a cross. You need to click and hold on the origin of your ruler and draw the opisometer on the map.
+* Draw the opisometer to follow the length of a route.
+* Click on the circle at the end to extend or shorten the opisometer.
+
+### Planimeter
+When you click the planimeter button, your cursor changes to a cross. You need to click and hold on the origin of your ruler and draw the planimeter on the map.
+* The planimeter will cover a 2D area.
+* Meanwhile your cursor is a cross, you can hold `SHIFT` to disallow path optimization.
+* A number with your "area unit" set in Units Editor → Distance → Area unit will appear. By default is "square" that appears as Km2.
+
 ## Routes
 
+In Layers → Routes you can show/hide routes on your map. In Style → select element "routes" you can change the how your routes look. Clicking on a route show their "edit route" menu. This have name, group, length and a row of buttons.
+
+* Name. Write on the text field to rename. Click speaker icon to make the software speak the name in audio. Click earth globe to create a new random name.
+* Group. Open the dropdown list to choose from a group. Click on pencil to open "edit route groups". You can add, remove and style route groups.
+* Length. Automatically calculated length appears in the length unit that you choose in units editor.
+* Pin. Create a new route selecting route cells.
+* Chain. Click to join the route to another route that starts or ends at the same cell.
+* Broken chain. Click on a control point to split the route there.
+* Graphic. Show the elevation profile for the route.
+* Edit free text notes (legend) for the route.
+* Lockpad. Click to lock route and prevent changes to it by regeneration tools.
+* Remove route. Shortcut: `delete` key.
+
+Clicking on menu → tools → edit → routes opens the "Routes Overview" menu. This shows a list of all routes on a table with sortable headers. Sorted by default by length. Click on a table header to change the sorting criteria. The table shows: Target icon, route name, route group, length, edit, lock and remove icons.
+* Clicking on the target icon focus the map on the selected route.
+* Edit icon opens the "edit route" menu.
+
+At the botton there is:
+* Total routes number.
+* Average length of a route in distance units.
+* Refresh the editor.
+* Pin. Create a new route selecting route cells.
+* Save routes-related data as a text file (.csv).
+* Lock or unlock all routes.
+* Remove all routes.
+
+## Scale bar
+
+At the bottom of your map you can see a scale bar. The scale bar is automatically adjusted to the distance unit you are using, the size of your world and the zoom you have. You can customize it at: Style → select element → Scale Bar.
+
 ## Grids
 
+Grid can be used to refer to several things. Grids due to the voronoi cells that create the map or aesthetic grids that are placed on top. Voronoi cell grids are discussed on another page, here we will talk about the aesthetic grids that can be activated and deactivated. These are called "overlay grids" or "grid overlay".
 
+to show/hide the grid go to: menu → layers → grid. You can customize the look and features of your grid in style → select element → grid. In style you can customize:
+* **Opacity** of the grid. From 0 invisible to 1 visible.
+* **Type**.
+    * Hex grid (pointy). Hexagons. They are joined horizontally at the sides. This makes them have two vertical vertices.
+    * Hex grid (flat). They are joined vertically at the sides. They show two horizontal vertices.
+    * Square grid. Squares parallel to the ground.
+* **Scale**. Default 1. Min: 0.1. Max: 10. Set the scale of the grid overlay.
+* Next to the scale is the **distance** between grid cell centers in map scale. Default: scale 1 → 75 km. Min: 0.1 → 7.5 km. Max: 10 → 750 km.
+* **Shift by axes**. The input fields are shifting in X or Y axis in pixels. By default 0, 0.
+* **Stroke color** of the grid. Color selector.
+* **Stroke width**. The line that draws the grid. By default 0.5. Min: 0. Max: 5.
+* **Stroke dash**. Write number on the input field to select a pattern. The first number is the length of the line, the second is the length of the blank space. Linecap is the border of the line. Choose from inherit, butt, round, square for linecap.
+* **Filter**. Apply predefined filters on the grid element.
+* **Clipping**. No clipping (appear everywhere), clip water (appear only on land), clip land (appear only on water).