NAME
d.scale - Overlays a bar scale and north arrow for the current
geographic region at a user-defined location in the active display frame.
(GRASS Display Program)
SYNOPSIS
d.scale
d.scale help
d.scale
[-m]
[bcolor=name]
[tcolor=name]
[at=x,y]
DESCRIPTION
d.scale overlays a bar scale and north arrow for
the current geographic region at a user-defined location in
the active display frame. The scale and north arrow are
proportioned to fit in the active frame when placed along
the frame's left edge.
The user can specify the location of the scale and north
arrow interactively (using a mouse), or provide the
geographic coordinates at which they will be placed. The
scale and north arrow will only overwrite those portions of
the graphics display that lie directly beneath them.
The user can also specify the colors in which the scale and north arrow
will be drawn. By default, if unspecified by the user, a white scale
and north arrow will be displayed on a black background.
OPTIONS
The user can run this program either non-interactively or interactively.
The program will be run non-interactively if the user specifies
program parameter values and desired flag settings
on the command line, using the form:
-
d.scale
[-m]
[bcolor=name]
[tcolor=name]
[at=x,y]
If at least one parameter value is given on the command line
and the -m flag is not set, the program will be run non-interactively;
any other parameter values left unspecified
on the command line will be set equal to their default values (see below).
Alternately, the user can simply type d.scale on the command line,
without program arguments. In this case, the user will be prompted for
needed parameter values and the flag setting using the standard GRASS
parser interface.
If the user sets the -m flag, d.scale will
expect the user to designate the scale's location interactively,
using the mouse.
Flag:
- -m
- Use the mouse to interactively place the location of
the scale and north arrow.
Parameters:
- bcolor=name
-
Set the background color underlying the scale and north
arrow to name.
Options: red, orange, yellow, green, blue, indigo, violet,
gray, brown, magenta, white, and black
Default: black
- tcolor=name
- Set the foreground color in which the text, scale, and north arrow
are displayed to name.
Options: Same as bcolor colors.
Default: white
- at=x,y
-
The map easting (x) and northing (y) geographic
coordinates designating the location at which the upper
left corner of the scale is to be placed. The user should
choose geographic coordinates located within the current
geographic region (see
d.where and
g.region for these
coordinates).
Default: 0.0,0.0
NOTES
d.scale
assumes that layer units are in meters.
The scale that d.scale generates is probably not suitable
for very tiny maps (in small display frames).
SEE ALSO
d.legend
d.measure
d.what.rast
d.what.vect
d.where
g.region
parser
AUTHOR
James Westervelt,
U.S. Army Construction Engineering
Research Laboratory