MapFrame

MapFrame

The MapFrame is the root element of the XML-file.

Attributes

The following attributes are required to create a map frame. However, bounds, srs and scale be specified at application level making the XML-file serve as a pure template.

bounds

Specifies the geographical extent of the map frame representing the inner reference boundary of the map frame. This frame will be referred to as the main frame. It contains a comma-separated list on the form "<minx>,<miny>,<maxx>,<maxy>" with coordinates in the map projection units.

srs

Specifies the spatial reference system of the map. It may take any form accepted by the PROJ library. This may be omitted, but it is then impossible to create graticule-related elements in the frame.

scale

Specifies the scale denominator of the map. Must be an integer.

margin

Specifies the distance in paper units of the main frame to the paper edge. In practice, provides the paper size of the resulting output. Can be a single value, in which the margin is the same on all sides, or a comma separated list of four values providing the left, bottom, right and top margins respectively.

bgcolor

Specifies a background color for the frame. This is the fill from the main frame and out to the paper edge. Default value is "white".

Child Elements

The MapFrame can have zero or more instances of the following elements. The order determines the painting order, with the first element on top.

• [Localization] (if present, must be the first element).
• [Label]
• [Border]
• [Ruler]

Example

<MapFrame bounds="557000,7025000,568000,7037000" 
      srs="EPSG:32632" 
      scale="50000" 
      margin="2cm,2cm,2cm,3cm">