NAME

d.label - Creates and displays text labels in the active display frame on the graphics monitor.
(GRASS Display Program)

SYNOPSIS

d.label
d.label help
d.label [size=value] [backcolor=name] [textcolor=name] [font=name]

DESCRIPTION

d.label allows the user to create and display text labels in the active frame on the graphics monitor. It interactively requests that the user type in text and use the pointing device (mouse) to identify where this text is to be placed within the active graphics frame. The program will prompt the user for label size, background color, text color, and text font type, if the user fails to specify these values on the command line. Program prompts use the standard GRASS parser interface.

Parameters:

size=value
Sets the label text size to the specified number. Values are stated as a percentage of the frame height; e.g., a size of 10 will make each line of text equal to one-tenth the height of the display frame.
Options: 0-1000
Default: 10
backcolor=name
Sets the color of the label background to the name stated.
Options: red, orange, yellow, green, blue, indigo, violet, gray, white, and black.
Default: black
textcolor=name
Sets the color of the label text to the name stated.
Options: same as for backcolor.
Default: white
font=name
Sets the font type used for the label's text to name.
Options: romand, romanp, romant, romans, scriptc, scripts, romancs, italicc, italiccs, gothitt, gothgrt, and gothgbt. The user can view these available fonts by running show.fonts.sh.
Default: romans (Roman simplex font type), or whatever font the user has set the font type to before entering d.label.

NOTES

This program will allow the user to display labels anywhere in the active display frame, even in areas lying outside of the current geographic region.

d.label will only allow the user to type in one line of text. The fully interactive program d.labels can be used to create text labels having as many as four lines.

d.label does not create paint labels files displayable by d.paint.labels -- d.labels does. These programs should be integrated in future GRASS releases.

BUGS

If the user is running GRASS under X Windows, and the user enters a text label longer than 80 characters (i.e., allows text to wrap onto a second line), X Windows will stop the user's GRASS graphics monitor without throwing the user out of GRASS. If this happens, the user should simply restart a graphics monitor, using d.mon.

SEE ALSO

d.display
d.font
d.labels
d.legend
d.mon
d.paint.labels
d.rast
d.scale
d.text
d.title
d.where
show.fonts.sh
parser

AUTHOR

James Westervelt, U.S. Army Construction Engineering Research Laboratory

Last changed: $Date: 2005/10/31 23:24:47 $