NAME
d.site.labels - Interactively label sites using a string or double
attribute value or the category value on the current graphics monitor.
(GRASS Display Program)
SYNOPSIS
d.site.labels
d.site.labels -m file=name
[attr=string|cat|double|coords|dim]
[index=number]
[xref=left|center|right]
[yref=top|center|bottom]
[size=number]
[color=colorname]
[backgr=colorname]
[border=colorname]
[font=fontname]
DESCRIPTION
d.site.labels performs interactive placement of labels for a
GRASS site_lists on the
current graphics monitor. Labels can be chosen from the category value, a
double attribute or a string attribute, the coordinates, or a dimension. The
default uses the first string attribute. The index is a number greater
than zero for the attribute to use as a label. The user may select the
position, color and sizing of the labels. Labels are only drawn within the
current region.
This program can be run non-interactively or interactively. If the user
gives the name of a GRASS site_lists and (optionally) any other
parameters, the command will be run non-interactively. Any parameter
left unspecified will be set to its default value (see below). Alternatively,
the user can type d.site.labels at the command line and be prompted
for the parameter values using the standard GRASS
parser interface.
Parameters:
- -m
- Use the mouse to place labels interactively. If the user chooses no, this
program behaves similarly to d.sites.label.
Default: No
- file=name
- Name of a GRASS site_lists map in the user's current mapset
search path.
- attr=string|cat|double|coords|dim
- Type of attribute to use for the label.
Default: string
- index=number
- Index number to the attribute. For instance, 3 would request
values from the third attribute column. This option is ignored if the
attr option is set to cat or coords.
Default: 1
- xref=left|center|right
- Horizontal label placement in relation to the site point.
Default: center
- yref=top|center|bottom
- Vertical label placement in relation to the site point.
- size=number
- The size of letters in pixels.
Default: 10
- color=colorname
- The GRASS colorname to use for the label text.
Options: red, orange, yellow, green, blue, indigo, violet, magenta, brown,
gray, white or black
Default: white
- backgr=colorname
- Color to use for text box background.
Options: grey, red, white, magenta, brown, blue, indigo, yellow, black, orange,
green, violet, none
Default: none
- border=colorname
- Color to use for text box border.
Options: grey, red, white, magenta, brown, blue, indigo, yellow, black, orange,
green, violet, none
Default: none
- font=fontname
- The GRASS fontname to use for the label.
Options: cyrilc, gothgbt, gothgrt, gothitt, greekc, greekcs, greekp,
greeks, italicc, italiccs, italict, romanc, romancs, romand,
romans, romant, scriptc or scripts
Default: romans
SEE ALSO
d.display
d.icons
d.sites
d.sites.label
d.points
d.rast
d.vect
g.region
parser
AUTHOR
Eric G. Miller, Unknown others
$Id: d.site.labels.html,v 1.7 2003/08/08 04:35:55 hamish Exp $
Last changed: $Date: 2003/08/08 04:35:55 $