User Tools

Site Tools


manual:advanced:map_tools:theming

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.

Internal themes

Definition of five default themes


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

Use only UTF-8 charset for filenames and other texts.

For more information about the custom map themes, please visit >>

manual/advanced/map_tools/theming.txt · Last modified: 2022/04/20 14:53 by mstupka