d.text - Draws text in the active display frame on the graphics monitor using the current font.
d.text [-b] [size=float] [color=string] [line=integer] [at=x,y] [rotation=float]
- Use bold text
- Height of letters in percentage of available frame height
- Options: 0-100
- Default: 5
- Text color, either a standard GRASS color or R:G:B triplet
- Default: gray
- The screen line number on which text will begin to be drawn
- Options: 1-1000
- Screen position at which text will begin to be drawn (percentage, [0,0] is lower left)
- Options: 0-100
- Rotation angle in degrees (counter-clockwise)
- Default: 0
d.text draws text in the active display frame on
the graphics monitor. Text can be provided through
standard input or redirected from a file (using the UNIX
In addition to the options provided on the command line,
colors, text size, font type, rotation angle, and boldness can be adjusted
with commands in the standard input (i.e., if the user
invokes d.text without options on the command
line, and then assigns values to these options on lines
within the standard input).
- .C color
(where color is one of the available colors) causes text appearing on
subsequent lines to be drawn in that color.
- .S size
(where size is a percentage within the range 0 to
100) adjusts text size. Note that a size of 10 would allow
10 lines to be drawn in the active display frame, 5 would
allow the drawing of 20 lines, and 50 would allow the
drawing of 2 lines.
- .F font
(where font is one of the fonts known by the GRASS program
the font type. Available fonts are listed in the GRASS manual entry for
The default font type used (if unspecified by the user)
- .R rotation
(where rotation is an angle in degrees, counter-clockwise)
to rotate the text.
- .B 1
- stipulates that following text be printed in bold.
This command means bold on.
- .B 0
- turns bold off of all text appearing on lines beneath
it. (Bold off is used by default, if unspecified by the user.)
The following command will print the short phrase "This is
a test of d.text" in the active display frame using the
color yellow, in bold, and using 4/100'ths (4%) of the
active frame's vertical space per line:
d.text << EOF
This is a test of d.text
The user presses control-d
(the "Ctrl" and "d" keys) to end input to d.text (equal to EOF).
Note that the GRASS command
d.title creates map TITLEs in a format
suitable for input to d.text.
d.text needs escape sequences that can be used
within lines to change colors, boldness, and perhaps size.
U.S. Army Construction Engineering
Last changed: $Date: 2005/11/01 00:01:58 $
Main index - display index - Full index