File: description.html

package info (click to toggle)
grass 6.0.2-6
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 40,044 kB
  • ctags: 31,303
  • sloc: ansic: 321,125; tcl: 25,676; sh: 11,176; cpp: 10,098; makefile: 5,025; fortran: 1,846; yacc: 493; lex: 462; perl: 133; sed: 1
file content (101 lines) | stat: -rw-r--r-- 3,000 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<H2>DESCRIPTION</H2>

<EM>d.text</EM> draws text in the active display frame on
the graphics monitor.  Text can be provided through
standard input or redirected from a file (using the UNIX
redirection mechanism).

In addition to the options provided on the command line,
colors, text size, font type, and boldness, can be adjusted
with commands in the standard input (i.e., if the user
invokes <EM>d.text</EM> without options on the command
line, and then assigns values to these options on lines
within the standard input).  In this case, the user also
sees the standard GRASS 
<A HREF="parser.html">parser</A> interface.

<H3>Commands:</H3> 

<DL>

<DT>.C <EM>color</EM> 
<DD>
(where <EM>color</EM> is one of the available colors) causes text appearing on 
subsequent lines to be drawn in that color. 

<DT><B>.S </B> <EM>size</EM>
<DD>
(where <EM>size</EM> is a percentage within the range 0 to
100) adjusts text size.  Note that a size of 10 would allow
10 lines to be drawn in the active display frame, 5 would
allow the drawing of 20 lines, and 50 would allow the
drawing of 2 lines.

<P>
<DT><B>.F</B> <EM>font</EM>
<DD>
(where <EM>font</EM> is one of the fonts known by the GRASS program 
<EM><A HREF="d.font.html">d.font</A></EM>) manipulates
the font type. Available fonts are listed in the GRASS manual entry for 
<EM><A HREF="d.font.html">d.font</A></EM>. 
The default font type used (if unspecified by the user) 
is <EM>romans</EM>.
Run the GRASS macro 
<EM><A  HREF="show.fonts.sh.html">show.fonts.sh</A></EM> 
to see what these fonts look like. 

<DT><B>.B 1</B>
<DD>stipulates that following text be printed in <B>bold</B>.
This command means <EM>bold on</EM>.

<DT><B>.B 0</B>
<DD> turns <EM>bold off</EM> of all text appearing on lines beneath 
     it. (<EM>Bold off</EM> is used by default, if unspecified by the user.) 

</DL>

<H2>EXAMPLE</H2>

The following command will print the short phrase "This is
a test of d.text" in the active display frame using the
color yellow, in bold, and using 4/100'ths (4%) of the
active frame's vertical space per line:
<P>

<DL>
<DT><B>d.text</B>
<dd>.C yellow 
<dd>.S 4 
<dd>.B 1
<dd>This is a test of d.text</B> 
</DL>

The user presses <EM>control-d</EM> 
(the "ctrl" and "d" keys) to end input to <EM>d.text</EM> (equal to EOF).

<H2>NOTES</H2>

Note that the GRASS command 
<EM><A HREF="d.title.html">d.title</A></EM> creates map TITLEs in a format 
suitable for input to <EM>d.text</EM>.

<P>

<EM>d.text</EM> needs escape sequences that can be used
within lines to change colors, boldness, and perhaps size.

<H2>SEE ALSO</H2>

<EM><A HREF="d.font.html">d.font</A></EM><br>
<EM><A HREF="d.title.html">d.title</A></EM><br>
<EM><A HREF="show.fonts.sh.html">show.fonts.sh</A></EM><br>
<EM><A HREF="d.text.freetype.html">d.text.freetype</A></EM><br>
<EM><A HREF="parser.html">parser</A></EM>

<H2>AUTHOR</H2>

James Westervelt, 
U.S. Army Construction Engineering 
Research Laboratory

<p><i>Last changed: $Date: 2003/04/11 15:25:34 $</i>