d.text.freetype(1)

NAME
d.text.freetype

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)

    [+|-]rotation[r] rotation (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.

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: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $

Full index

© 2003-2011 GRASS Development Team