d.text(1)

1d.text(1)                     Grass User's Manual                    d.text(1)
2
3
4

NAME

6       d.text   - Draws text in the active display frame on the graphics moni‐
7       tor using the current font.
8

KEYWORDS

10       display
11

SYNOPSIS

13       d.text
14       d.text help
15       d.text [-b]  [size=float]   [color=string]   [line=integer]    [at=x,y]
16       [rotation=float]
17
18   Flags:
19       -b  Use bold text
20
21   Parameters:
22       size=float
23           Height  of letters in percentage of available frame height Options:
24           0-100 Default: 5
25
26       color=string
27           Text color, either a standard GRASS color or R:G:B triplet Default:
28           gray
29
30       line=integer
31           The  screen  line  number  on  which  text  will  begin to be drawn
32           Options: 1-1000
33
34       at=x,y
35           Screen position at which text will begin to be  drawn  (percentage,
36           [0,0] is lower left) Options: 0-100
37
38       rotation=float
39           Rotation angle in degrees (counter-clockwise) Default: 0
40

DESCRIPTION

42       d.text  draws text in the active display frame on the graphics monitor.
43       Text can be provided through standard input or redirected from  a  file
44       (using  the  UNIX  redirection  mechanism).  In addition to the options
45       provided on the command line, colors, text size,  font  type,  rotation
46       angle, and boldness can be adjusted with commands in the standard input
47       (i.e., if the user invokes d.text without options on the command  line,
48       and  then  assigns values to these options on lines within the standard
49       input).
50
51   Commands:
52       .C color
53              (where color is one of the available colors) causes text appear‐
54              ing on subsequent lines to be drawn in that color.
55
56       .S  size
57              (where  size  is a percentage within the range 0 to 100) adjusts
58              text size.  Note that a size of 10 would allow 10  lines  to  be
59              drawn  in the active display frame, 5 would allow the drawing of
60              20 lines, and 50 would allow the drawing of 2 lines.
61
62       .F font
63              (where font is one of the  fonts  known  by  the  GRASS  program
64              d.font) manipulates the font type. Available fonts are listed in
65              the GRASS manual entry for d.font.  The default font  type  used
66              (if unspecified by the user) is romans.
67
68       .R  rotation
69              (where  rotation  is  an angle in degrees, counter-clockwise) to
70              rotate the text.
71
72       .B 1   stipulates that following text be printed in bold.  This command
73              means bold on.
74
75       .B 0   turns  bold off of all text appearing on lines beneath it. (Bold
76              off is used by default, if unspecified by the user.)
77

EXAMPLE

79       The following command will print the short phrase "This is  a  test  of
80       d.text"  in  the  active display frame using the color yellow, in bold,
81       and using 4/100'ths (4%) of the active frame's vertical space per line:
82
83
84           d.text << EOF
85           .C yellow
86           .S 4
87           .B 1
88           This is a test of d.text
89           EOF
90        The user presses control-d (the "Ctrl" and "d" keys) to end  input  to
91       d.text (equal to EOF).
92

NOTES

94       Note  that  the  GRASS  command  d.title creates map TITLEs in a format
95       suitable for input to d.text.
96
97       d.text needs escape sequences that can be used within lines  to  change
98       colors, boldness, and perhaps size.
99

AUTHOR

108       James  Westervelt,  U.S. Army Construction Engineering Research Labora‐
109       tory
110
111       Last changed: $Date: 2005/11/01 00:01:58 $
112
113       Full index
114
115
116
117GRASS 6.2.2                                                          d.text(1)