====== LoMaps Theming ======

----
===== LoMaps content =====

==== Basic information ====

This page contains the **mapping XML** file used by Locus Map for generating OSM-based vector maps.

==== TAG file ====

The XML file used for the generation of vector maps contains a combination of OSM tag KEY-VALUE of elements that are rendered in Locus vector maps. <WRAP center round download 60%> **{{:manual:advanced:map_tools:tag-mapping_20170119.zip|tag-mapping_20170119.zip}}  ** </WRAP>


==== Internal themes ====

Definition of five default themes <WRAP center round download 60%> **{{:manual:advanced:map_tools:locus_internal_theme_20170119.zip|locus_internal_theme_20170119.zip}} ** </WRAP>

----


===== LoMaps - theme configuration =====


==== Supported tags ====

=== area ===

  * src
  * fill
  * stroke
  * stroke-width

=== caption ===

  * k
  * dx
  * dy
  * font-family
  * font-style
  * font-size
  * fill
  * stroke
  * stroke-width
  * upper-case
  * scale-font-size
  * bg-rect-fill
  * bg-rect-stroke
  * bg-rect-over
  * bg-rect-stroke-width
  * bg-rect-rounded
  * priority
  * force-draw

=== circle ===

  * r
  * scale-radius
  * fill
  * stroke
  * stroke-width

=== line ===

  * curve
  * dy
  * src
  * stroke
  * stroke-width
  * stroke-dasharray
  * stroke-linecap

=== lineSymbol ===

  * src
  * align-center
  * repeat
  * repeat-gap
  * scale
  * scale-icon-size

=== pathText ===

  * k
  * font-family
  * font-style
  * font-size
  * fill
  * stroke
  * stroke-width
  * dx
  * dy
  * upper-case
  * rotate_up
  * scale-font-size
  * bg-rect-fill
  * bg-rect-stroke
  * bg-rect-over
  * bg-rect-stroke-width
  * bg-rect-rounded

=== symbol ===

  * src
  * scale
  * scale-icon-size
  * symbol-width
  * symbol-height
  * priority
  * force-draw


==== Detailed information about tags ====

=== curve ===

Adds possibility to draw line extrapolated as a curve. It helps in some situations to create "smooth" lines:

  * value: "cubic"
  * example: ''<line stroke="#A07F5F" stroke-width="0.08" curve="cubic"/>''

=== bg-rect-* ===

A background rectangle is a very useful method of drawing a nicely looking rectangle as a background for texts.

  * bg-rect-fill
      * more in **fill**  attribute
  * bg-rect-stroke
      * more in **stroke**  attribute
  * bg-rect-over
      * space between text and border
      * value: decimal number
  * bg-rect-stroke-width
      * more in **stroke-width**
  * bg-rect-rounded
      * allow to round corners of bounding rectgangle
      * value: decimal number

  * used in: caption, pathText

=== fill ===

  * Fills colors of items.
  * value: color

=== force-draw ===

  * useful method of drawing an icon no matter if others overlay it or not
  * value: boolean

=== rotate_up ===

  * default value ''rotate_up="true"''  automatically rotates text up. It means that path text doesn't follow the direction of the way but it automatically rotates to the readable direction. This is not ideal for contour lines where text should follow the gradient. Set to ''rotate_up="true"''  and next will be in the same direction as the direction of the way

=== scale ===

  * Scale symbol for drawing
  * default: 1.0f
  * value: decimal number

=== scale-icon-size ===

  * Allows scaling a symbol based on the current zoom level. A very useful method of increasing the size of symbols on the map when you change the zoom level. The method is defined by two values separated by a comma, where 1st value is the base zoom level, and the 2nd value is the exponent. The base scale value is from attribute **scale**.

  * example: ''scale="1.5" scale-icon-size="12,1.1"''
      * for zoom levels 0 - 11, scale: **1.5**
      * for zoom level 12, scale: 1.5 * 1.0 = **1.5**
      * for zoom level 13, scale:
        * zoom level difference: 1
        * scale: 1.5 * 1.1 = **1.65**
      * for zoom level 15, scale:
        * zoom level difference: 3
        * scale: 1.5 * 1.1 * 1.1 * 1.1 = **2.00**

=== stroke ===

  * Stroke colors for items.
  * value: color

=== stroke-width ===

  * Width of the stroke color
  * value: decimal number

=== symbol-width, symbol-height ===

enables to resize the symbol icon to specific width or height

  * value: decimal number

=== upper-case ===

  * allows to display texts in upper-case
  * used in: caption, pathText
  * value: boolean


==== Possible values ====

=== boolean ===

Boolean value may be written as text ''true'', ''false'' or as number ''1'' (as ''true''), ''0'' (as ''false'')

=== colour ===

Supported formats are: #RRGGBB #AARRGGBB 'red', 'blue', 'green', 'black', 'white', 'gray', 'cyan', 'magenta', 'yellow', 'lightgray', 'darkgray'

=== decimal number ===

Common decimal number
<WRAP center round important>
Use only **UTF-8** charset for filenames and other texts.
</WRAP>
For more information about the custom map themes, **[[https://medium.com/@menion.asamm/custom-map-themes-in-locus-map-203aead34ccb|please visit >>]]**