The <scaletext> element is used to add text containing the map scale to the map template.

Note that the position attribute must be defined in the units defined by the units attribute of the <template> element, but the font-size is always defined in points.

Frequency Parent Elements (the <scaletext> element is valid within): PO+ <template>

Frequency Description (in this context) PO+ The <scaletext> element may appear one or more times within the <template> element in any order.

Attributes Description position The page position of the text, expressed in the units specified in the units attribute of the <template> element. The position should be two numbers separated by a comma (with no white space), representing the x and y location. For example, if the units are "points", a value of "72,72" would indicate a position one inch from the left side and bottom side of the page. Required. alignment The alignment of the text, relative to the position. Valid values are "left", "right", and "center". Required. font The font of the text, chosen from one of the following valid font names: "helvetica", "helvetica_bold", "helvetica_boldoblique", "helvetica_oblique", "times_roman", "times_bold", "times_bolditalic", "times_italic", "courier", "courier_bold", "courier_boldoblique", "courier_oblique". Optional, defaults to "helvetica". font-size The font size for the text, expressed in points. Integer value expected, example: font-size="9". Optional, defaults to "9". prefix Text to appear before the scale. Example: prefix="Scale: 1:". Optional, defaults to no prefix. suffix Text to appear after the scale text. Optional, defaults to no suffix.

Example:

<scaletext position="768,50" font="helvetica" font-size="9" prefix="Scale 1:" alignment="right"/>