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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
|
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.0.3, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<!-- This manual documents GNU troff version 1.23.0.
Copyright 1994-2023 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<title>Graphics Commands (The GNU Troff Manual)</title>
<meta name="description" content="Graphics Commands (The GNU Troff Manual)">
<meta name="keywords" content="Graphics Commands (The GNU Troff Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="Request-Index.html" rel="index" title="Request Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Command-Reference.html" rel="up" title="Command Reference">
<link href="Device-Control-Commands.html" rel="next" title="Device Control Commands">
<link href="Simple-Commands.html" rel="prev" title="Simple Commands">
<style type="text/css">
<!--
div.example {margin-left: 3.2em}
span.r {font-family: initial; font-weight: normal; font-style: normal}
-->
</style>
</head>
<body lang="en">
<div class="subsubsection-level-extent" id="Graphics-Commands">
<div class="nav-panel">
<p>
Next: <a href="Device-Control-Commands.html" accesskey="n" rel="next">Device Control Commands</a>, Previous: <a href="Simple-Commands.html" accesskey="p" rel="prev">Simple Commands</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Request-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h4 class="subsubsection" id="Graphics-Commands-1">6.1.2.3 Graphics Commands</h4>
<p>Each graphics or drawing command in the intermediate output starts with
the letter ‘<samp class="samp">D</samp>’, followed by one or two characters that specify a
subcommand; this is followed by a fixed or variable number of integer
arguments that are separated by a single space character. A ‘<samp class="samp">D</samp>’
command may not be followed by another command on the same line (apart
from a comment), so each ‘<samp class="samp">D</samp>’ command is terminated by a syntactical
line break.
</p>
<p><code class="code">gtroff</code> output follows the classical spacing rules (no space
between command and subcommand, all arguments are preceded by a single
space character), but the parser allows optional space between the
command letters and makes the space before the first argument optional.
As usual, each space can be any sequence of tab and space characters.
</p>
<p>Some graphics commands can take a variable number of arguments. In this
case, they are integers representing a size measured in basic units
‘<samp class="samp">u</samp>’. The arguments called <var class="var">h1</var>, <var class="var">h2</var>, …, <var class="var">hn</var>
stand for horizontal distances where positive means right, negative
left. The arguments called <var class="var">v1</var>, <var class="var">v2</var>, …, <var class="var">vn</var> stand
for vertical distances where positive means down, negative up. All
these distances are offsets relative to the current location.
</p>
<p>Each graphics command directly corresponds to a similar <code class="code">gtroff</code>
<code class="code">\D</code> escape sequence. See <a class="xref" href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a>.
</p>
<p>Unknown ‘<samp class="samp">D</samp>’ commands are assumed to be device-specific. Its
arguments are parsed as strings; the whole information is then sent to
the postprocessor.
</p>
<p>In the following command reference, the syntax element ‹<span class="r">line
break</span>› means a syntactical line break as defined above.
</p>
<dl class="table">
<dt><code class="code">D~ <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> … <var class="var">hn</var> <var class="var">vn</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw B-spline from current position to offset (<var class="var">h1</var>,<var class="var">v1</var>), then
to offset (<var class="var">h2</var>,<var class="var">v2</var>), if given, etc., up to
(<var class="var">hn</var>,<var class="var">vn</var>). This command takes a variable number of argument
pairs; the current position is moved to the terminal point of the drawn
curve.
</p>
</dd>
<dt><code class="code">Da <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw arc from current position to
(<var class="var">h1</var>,<var class="var">v1</var>)<em class="math">+</em>(<var class="var">h2</var>,<var class="var">v2</var>) with center at
(<var class="var">h1</var>,<var class="var">v1</var>); then move the current position to the final point
of the arc.
</p>
</dd>
<dt><code class="code">DC <var class="var">d</var>‹<span class="r">line break</span>›</code></dt>
<dt><code class="code">DC <var class="var">d</var> <var class="var">dummy-arg</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw a solid circle using the current fill color with
diameter <var class="var">d</var> (integer in basic units ‘<samp class="samp">u</samp>’) with leftmost
point at the current position; then move the current position to the
rightmost point of the circle. An optional second integer argument is
ignored (this allows the formatter to generate an even number of
arguments). This command is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">Dc <var class="var">d</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw circle line with diameter <var class="var">d</var> (integer in basic units
‘<samp class="samp">u</samp>’) with leftmost point at the current position; then move the
current position to the rightmost point of the circle.
</p>
</dd>
<dt><code class="code">DE <var class="var">h</var> <var class="var">v</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw a solid ellipse in the current fill color with a horizontal
diameter of <var class="var">h</var> and a vertical diameter of <var class="var">v</var> (both
integers in basic units ‘<samp class="samp">u</samp>’) with the leftmost point at the current
position; then move to the rightmost point of the ellipse. This command
is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">De <var class="var">h</var> <var class="var">v</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw an outlined ellipse with a horizontal diameter of <var class="var">h</var> and
a vertical diameter of <var class="var">v</var> (both integers in basic units
‘<samp class="samp">u</samp>’) with the leftmost point at current position; then move to the
rightmost point of the ellipse.
</p>
</dd>
<dt><code class="code">DF <var class="var">color-scheme</var> <span class="r">[</span><var class="var">component</var> …<span class="r">]</span>‹<span class="r">line break</span>›</code></dt>
<dd><p>Set fill color for solid drawing objects using different color schemes;
the analogous command for setting the color of text, line graphics, and
the outline of graphic objects is ‘<samp class="samp">m</samp>’. The color components are
specified as integer arguments between 0 and 65535. The number of color
components and their meaning vary for the different color schemes.
These commands are generated by <code class="code">gtroff</code>’s escape sequences
‘<samp class="samp">\D'F …'</samp>’ and <code class="code">\M</code> (with no other corresponding
graphics commands). No position changing. This command is a
<code class="code">gtroff</code> extension.
</p>
<dl class="table">
<dt><code class="code">DFc <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Set fill color for solid drawing objects using the CMY color scheme,
having the 3 color components <var class="var">cyan</var>, <var class="var">magenta</var>, and
<var class="var">yellow</var>.
</p>
</dd>
<dt><code class="code">DFd‹<span class="r">line break</span>›</code></dt>
<dd><p>Set fill color for solid drawing objects to the default fill color value
(black in most cases). No component arguments.
</p>
</dd>
<dt><code class="code">DFg <var class="var">gray</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Set fill color for solid drawing objects to the shade of gray given by
the argument, an integer between 0 (black) and 65535 (white).
</p>
</dd>
<dt><code class="code">DFk <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var> <var class="var">black</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Set fill color for solid drawing objects using the CMYK color scheme,
having the 4 color components <var class="var">cyan</var>, <var class="var">magenta</var>,
<var class="var">yellow</var>, and <var class="var">black</var>.
</p>
</dd>
<dt><code class="code">DFr <var class="var">red</var> <var class="var">green</var> <var class="var">blue</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Set fill color for solid drawing objects using the RGB color scheme,
having the 3 color components <var class="var">red</var>, <var class="var">green</var>, and
<var class="var">blue</var>.
</p></dd>
</dl>
</dd>
<dt><code class="code">Df <var class="var">n</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The argument <var class="var">n</var> must be an integer in the range <em class="math">-32767</em>
to 32767.
</p>
<dl class="table">
<dt><em class="math">0 ≤ <var class="var">n</var> ≤ 1000</em></dt>
<dd><p>Set the color for filling solid drawing objects to a shade of gray,
where 0 corresponds to solid white, 1000 (the default) to solid black,
and values in between to intermediate shades of gray; this is obsoleted
by command ‘<samp class="samp">DFg</samp>’.
</p>
</dd>
<dt><em class="math"><var class="var">n</var> < 0</em> or <em class="math"><var class="var">n</var> > 1000</em></dt>
<dd><p>Set the filling color to the color that is currently being used for the
text and the outline, see command ‘<samp class="samp">m</samp>’. For example, the command
sequence
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">mg 0 0 65535
Df -1
</pre></div></div>
<p>sets all colors to blue.
</p></dd>
</dl>
<p>No position changing. This command is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">Dl <var class="var">h</var> <var class="var">v</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw line from current position to offset (<var class="var">h</var>,<var class="var">v</var>) (integers in
basic units ‘<samp class="samp">u</samp>’); then set current position to the end of the drawn
line.
</p>
</dd>
<dt><code class="code">Dp <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> … <var class="var">hn</var> <var class="var">vn</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw a polygon line from current position to offset (<var class="var">h1</var>,<var class="var">v1</var>),
from there to offset (<var class="var">h2</var>,<var class="var">v2</var>), etc., up to offset
(<var class="var">hn</var>,<var class="var">vn</var>), and from there back to the starting position. For
historical reasons, the position is changed by adding the sum of all
arguments with odd index to the actual horizontal position and the even
ones to the vertical position. Although this doesn’t make sense it is
kept for compatibility.
This command is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">DP <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> … <var class="var">hn</var> <var class="var">vn</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Draw a solid polygon in the current fill color rather than an outlined
polygon, using the same arguments and positioning as the corresponding
‘<samp class="samp">Dp</samp>’ command.
This command is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">Dt <var class="var">n</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>Set the current line thickness to <var class="var">n</var> (an integer in basic
units ‘<samp class="samp">u</samp>’) if <em class="math"><var class="var">n</var>>0</em>; if <em class="math"><var class="var">n</var>=0</em> select the
smallest available line thickness; if <em class="math"><var class="var">n</var><0</em> set the line
thickness proportional to the type size (this is the default before the
first ‘<samp class="samp">Dt</samp>’ command was specified). For historical reasons, the
horizontal position is changed by adding the argument to the actual
horizontal position, while the vertical position is not changed.
Although this doesn’t make sense it is kept for compatibility.
This command is a <code class="code">gtroff</code> extension.
</p></dd>
</dl>
</div>
<hr>
<div class="nav-panel">
<p>
Next: <a href="Device-Control-Commands.html">Device Control Commands</a>, Previous: <a href="Simple-Commands.html">Simple Commands</a>, Up: <a href="Command-Reference.html">Command Reference</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Request-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
