man d.text.freetype () - Draws text in the graphics monitor's active display frame using TrueType fonts.

NAME

d.text.freetype - Draws text in the graphics monitor's active display frame using TrueType fonts.

SYNOPSIS

d.text.freetype

d.text.freetype help

d.text.freetype [-brpnsc] [text=string] [east_north=east,north] [path=string] [charset=string] [color=string] [size=float] [align=string] [rotation=float] [linespacing=float]

Flags:

"-b
Use bold text
"-r
Use radians instead of degrees for rotation
"-p
Coordinates are in pixels ([0,0] is top left)
"-n
Coordinates are percentage of frame ([0,0] is bottom left)
"-s
Font size is height in pixels
"-c
Command mode (Compatibility with d.text)

Parameters:

"text=string
Text (enclose multiple words "in quotes")
"east_north=east,north
Map coordinates
"path=string
Path to TrueType font (including file name)
"charset=string
Character encoding (default: UTF-8)
"color=string
Text color, either a standard GRASS color or R:G:B triplet (separated by colons) Default: gray
"size=float
Height of letters (in percent of available frame height) Default: 5
"align=string
Text alignment Options: ll,lc,lr,cl,cc,cr,ul,uc,ur Default: ll
"rotation=float
Rotation angle in degrees (counterclockwise) Default: 0
"linespacing=float
Line spacing Default: 1.1

DESCRIPTION

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:

"east_north=easting,northing
Locates the text at these map coordinates. 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,
Radian, Percentage, and Pixels respectively

Commands

".F
".C
".S
".B
".A
".R
".I
".X
".Y
".L
".E
".N
"..

To end input, press Ctrl-d on a blank line.



EXAMPLES

Standard mode: d.text.freetype text="GRASS GIS" east_north=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 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.



SEE ALSO

d.text

d.font.freetype

d.font

d.title

d.where



AUTHOR

Huidae Cho grass4u@gmail.com>

Updates by Hamish Bowman, NZ

Last changed: $Date: 2004/10/28 21:00:28 $

Help Index