d.text.freetype(1)

1d.text.freetype(1)            Grass User's Manual           d.text.freetype(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  [-mpgbrsc]    [text=string]     [size=float]     [color=string]
16       [line=integer]    [at=x,y]   [align=string]   [rotation=float]   [line‐
17       spacing=float]     [font=string]     [path=string]     [charset=string]
18       [--verbose]  [--quiet]
19
20   Flags:
21       -m
22           Use mouse to interactively place text
23
24       -p
25           Screen position in pixels ([0,0] is top left)
26
27       -g
28           Screen position in geographic coordinates
29
30       -b
31           Use bold text
32
33       -r
34           Use radians instead of degrees for rotation
35
36       -s
37           Font size is height in pixels
38
39       -c
40           Ignored (compatibility with d.text.freetype)
41
42       --verbose
43           Verbose module output
44
45       --quiet
46           Quiet module output
47
48   Parameters:
49       text=string
50           Text to display
51
52       size=float
53           Height of letters in percentage of available frame height
54           Options: 0-100
55           Default: 5
56
57       color=string
58           Text color, either a standard GRASS color or R:G:B triplet
59           Default: gray
60
61       line=integer
62           The screen line number on which text will begin to be drawn
63           Options: 1-1000
64
65       at=x,y
66           Screen  position  at which text will begin to be drawn (percentage,
67           [0,0] is lower left)
68
69       align=string
70           Text alignment
71           Options: ll,lc,lr,cl,cc,cr,ul,uc,ur
72           Default: ll
73
74       rotation=float
75           Rotation angle in degrees (counter-clockwise)
76           Default: 0
77
78       linespacing=float
79           Line spacing
80           Default: 1.25
81
82       font=string
83           Font name
84
85       path=string
86           Path to font file
87
88       charset=string
89           Text encoding (only applicable to TrueType fonts)
90

DESCRIPTION

92       d.text.freetype draws text in the  graphics  monitor's  active  display
93       frame using TrueType fonts already installed on the user's system.
94
95   Parameter Notes:
96       at=x,y
97              Locates  the  text at this screen position (percentage, [0,0] is
98              bottom left). If this  option  is  omitted,  the  user  will  be
99              prompted to use the mouse to specify the location.
100
101       font=name
102              Specifies  a  font  listed in the GRASS 'freetypecap' definition
103              file.
104
105       charset=name
106              Sets character encoding for input text. (e.g. ISO-8859-1)
107
108       color=name
109              Sets text color to name or R:G:B triplet.   It  can  also  be  a
110              hexadecimal value of 0xRRGGBB (deprecated).
111              Options: red, orange, yellow, green, blue, indigo, violet, gray,
112              white, and black
113              Default: gray
114
115       size=value
116              Sets text height in percent of available frame height.
117              Default: 10
118
119       align=name
120              Aligns text in this way.
121              Options: ll, lc, lr, cl, cc, cr, ul, uc, ur
122              l?: Lower, c?: Vertically Centered, u?: Upper,
123              ?l: Left, ?c: Horizontally Centered, ?r: Right
124              Default: ll (Lower Left)
125
126   Command mode:
127   Key
128       {REQUIRED}
129
130       [OPTIONAL]
131
132       THIS|orTHAT
133
134       +, -
135              Relative value
136
137       r, %, p
138              Radian, Percentage, and Pixels respectively
139
140   Commands
141
142
143
144
145
146              .IP "
147              {0|1} bold (default: 0)
148
149
150
151
152              [+|-]rotation[r] rotation (default: 0)
153
154
155              linespacing linespacing (default: 1.1)
156
157
158
159
160
161
162
163
164
165
166
167
168
169       To end input, press Ctrl-d on a blank line.
170

EXAMPLES

172   Standard mode:
173       d.text.freetype text="GRASS GIS" -g at=2107055,5603133 \
174       size=7 path=/usr/X11R6/lib/X11/fonts/TTF/luximb.ttf
175
176   Command mode:
177       The following example prints three lines: "GRASS  d.text.freetype  out‐
178       put", "See test.input file", and "for more details.".
179
180       d.text.freetype -c
181              .br
182              GRASS
183               d.text.freetype
184               output
185              See test.input file
186              for more details.
187
188       Command mode instructions may also be read directly from a text file:
189       d.text.freetype -c < test.input
190

DEFINITION FILE

192       To  help  users  select fonts conveniently, the definition file, $(GIS‐
193       BASE)/etc/freetypecap, is provided.  Its format is as follows:
194            font:fontpath:charset:description
195            *default_font:fontpath:charset:description
196        See the file for examples.
197

AUTHOR

206       Huidae Cho grass4u@gmail.com>
207
208       Updates by Hamish Bowman, NZ
209
210       Last changed: $Date: 2007-04-07 13:34:10 +0200 (Sat, 07 Apr 2007) $
211
212       Full index
213
214       © 2003-2008 GRASS Development Team
215
216
217
218GRASS 6.3.0                                                 d.text.freetype(1)