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 $