NAME¶
d.text - Draws text in the active display frame on the graphics
monitor using the current font.
KEYWORDS¶
display, cartography
SYNOPSIS¶
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]
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
- bgcolor=string
-
Text background color, either a standard GRASS color or R:G:B triplet
- 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)
-
-
-
-
[+|-]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-2014 GRASS Development Team