NAME

SYNOPSIS

DESCRIPTION

d.site.labels performs interactive placement of labels for a GRASS sites_list 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 sites_list 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 sites_list 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

AUTHOR

Eric G. Miller, Unknown others

$Id$

Last changed: $Date$