d.text.freetype1grass
Draws text in the active display frame on the graphics monitor using the current font.
Usage
d.text
d.text help
d.text [-mpgbrsc]
[text=string]
[size=float]
[color=string]
[bgcolor=string]
[line=integer]
[at=x,y]
[align=string]
[rotation=float]
[linespacing=float]
[font=string]
[path=string]
[charset=string]
[--verbose]
[--quiet]
Keywords
display, cartography
Overview
d.text.freetype draws text in the graphics monitor's active display frame using TrueType fonts already installed on the user's system.
Parameter Notes:
at=x,y-
Locates the text at this screen position (percentage, [0,0] is bottom left). If this option is omitted, the user will be prompted to use the mouse to specify the location.
font=name-
Specifies a font listed in the GRASS 'freetypecap' definition file.
charset=name-
Sets character encoding for input
text. (e.g. ISO-8859-1)
color=name-
Sets text color to name or R:G:B triplet. It can also be a hexadecimal value of 0xRRGGBB (deprecated).
Options: red, orange, yellow, green, blue, indigo, violet, gray, white, and black
Default: gray
size=value-
Sets text height in percent of available frame height.
Default: 10
align=name-
Aligns text in this way.
Options: ll, lc, lr, cl, cc, cr, ul, uc, ur
l?: Lower, c?: Vertically Centered, u?: Upper,
?l: Left, ?c: Horizontally Centered, ?r: Right
Default: ll (Lower Left)
Command mode:
Key
- {REQUIRED}
- [OPTIONAL]
- THIS|orTHAT
- +, -
-
Relative value
- r, %, p
-
Radian, Percentage, and Pixels respectively
Commands
-
{0|1} bold (default: 0)
-
linespacing linespacing (default: 1.1)
To end input, press Ctrl-d on a blank line.
Examples
Standard mode:
d.text.freetype text="GRASS GIS" -g at=2107055,5603133 \
size=7 path=/usr/X11R6/lib/X11/fonts/TTF/luximb.ttf
Command mode:
The following example prints three lines: "GRASS d.text.freetype output", "See test.input file", and "for more details.".
d.text.freetype -c
GRASS
d.text.freetype
output
See test.input file
for more details.
Command mode instructions may also be read directly from a text file:
d.text.freetype -c < test.input
Definition file
To help users select fonts conveniently, the definition file, $(GISBASE)/etc/freetypecap, is provided. Its format is as follows:
font:fontpath:charset:description
*default_font:fontpath:charset:description
See the file for examples.
Releases
5 releases since Debian 4.0 (Etch); the text changed 4 times.