1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
**-L**\ [**g**\ \|\ **j**\ \|\ **J**\ \|\ **n**\ \|\ **x**]\ *refpoint*\ **+c**\ [*slon*/]\ *slat*\ **+w**\ *length*\ [**e**\ \|\ **f**\ \|\ **k**\ \|\ **M**\ \|\ **n**\ \|\ **u**]\ [\ **+a**\ *align*]\ [**+f**]\ [\ **+l**\ [*label*]\ ]\ [**+u**]
Draws a simple map scale centered on the reference point specified
using one of four coordinate systems:
(1) Use **-Dg** for map (user) coordinates, (2) use **-Dj** or **-DJ** for setting *refpoint* via
a 2-char justification code that refers to the (invisible) map domain rectangle,
(3) use **-Dn** for normalized (0-1) coordinates, or (4) use **-Dx** for plot coordinates
(inches, cm, etc.). Scale is calculated for latitude *slat*
(optionally supply longitude *slon* for oblique projections [Default
is central meridian]), *length* is in km, or append unit from
**e**\ \|\ **f**\ \|\ **k**\ \|\ **M**\ \|\ **n**\ \|\ **u**.
Change the label alignment with **+a**\ *align* (choose among
**l**\ (eft), **r**\ (ight), **t**\ (op), and **b**\ (ottom)).
Append **+f** to get a "fancy" scale [Default is plain].
Append **+l** to select the default label, which equals the distance
unit (meter, foot, km, mile, nautical mile, US survey foot) and is
justified on top of the scale [t]. Change this by giving your own
label (append **+l**\ *label*).
Select **+u** to append the unit to all distance annotations along the
scale (for the plain scale, **+u** will instead select the unit to be
appended to the distance length). Note:
Use :ref:`FONT_LABEL <FONT_LABEL>` to change the label font and
:ref:`FONT_ANNOT_PRIMARY <FONT_ANNOT_PRIMARY>`
to change the annotation font. The height of the map scale is controlled
by :ref:`MAP_SCALE_HEIGHT <MAP_SCALE_HEIGHT>`, and the pen thickness is
set by :ref:`MAP_TICK_PEN_PRIMARY <MAP_TICK_PEN_PRIMARY>`.
See **-F** on how to place a panel behind the scale.
|
