1d.text(1) Grass User's Manual d.text(1)
2
3
4
6 d.text - Draws text in the active display frame on the graphics moni‐
7 tor using the current font.
8
10 display
11
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
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
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
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
101 d.font
102 d.font.freetype
103 d.title
104 d.text.freetype
105 d.labels
106
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)