d.text.freetype

Langue: en

Autres versions - même langue

Version: 372768 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

d.text - Draws text in the active display frame on the graphics monitor using the current font.

KEYWORDS

display

SYNOPSIS

d.text
d.text help
d.text [-mpgbrsc] [text=string] [size=float] [color=string] [line=integer] [at=x,y] [align=string] [rotation=float] [linespacing=float] [font=string] [path=string] [charset=string] [--verbose] [--quiet]

Flags:

-m

Use mouse to interactively place text
-p

Screen position in pixels ([0,0] is top left)
-g

Screen position in geographic coordinates
-b

Use bold text
-r

Use radians instead of degrees for rotation
-s

Font size is height in pixels
-c

Ignored (compatibility with d.text.freetype)
--verbose

Verbose module output
--quiet

Quiet module output

Parameters:

text=string

Text to display
size=float

Height of letters in percentage of available frame height
Options: 0-100
Default: 5
color=string

Text color, either a standard GRASS color or R:G:B triplet
Default: gray
line=integer

The screen line number on which text will begin to be drawn
Options: 1-1000
at=x,y

Screen position at which text will begin to be drawn (percentage, [0,0] is lower left)
align=string

Text alignment
Options: ll,lc,lr,cl,cc,cr,ul,uc,ur
Default: ll
rotation=float

Rotation angle in degrees (counter-clockwise)
Default: 0
linespacing=float

Line spacing
Default: 1.25
font=string

Font name
path=string

Path to font file
charset=string

Text encoding (only applicable to TrueType fonts)

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:

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 rs
size=7 path=/usr/X11R6/lib/X11/fonts/TTF/luximb.ttf

Command mode:

The following example prints three lines: "GRASS d.text.freetype output", dqSee test.input file", and dqfor 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.

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: 2007-04-07 13:34:10 +0200 (Sat, 07 Apr 2007) $

Full index

© 2003-2008 GRASS Development Team