1 058b0118 2005-01-03 devnull .TH PLOT 7
3 058b0118 2005-01-03 devnull plot \- graphics interface
4 058b0118 2005-01-03 devnull .SH DESCRIPTION
5 058b0118 2005-01-03 devnull Files of this format are interpreted by
6 058b0118 2005-01-03 devnull .IR plot (1)
7 058b0118 2005-01-03 devnull to draw graphics on the screen.
10 058b0118 2005-01-03 devnull file is a
12 058b0118 2005-01-03 devnull stream of
13 058b0118 2005-01-03 devnull instruction lines.
14 058b0118 2005-01-03 devnull Arguments are delimited by spaces, tabs, or commas.
15 058b0118 2005-01-03 devnull Numbers may be floating point.
16 058b0118 2005-01-03 devnull Punctuation marks (except
19 058b0118 2005-01-03 devnull spaces, and tabs at the beginning of lines are ignored.
20 058b0118 2005-01-03 devnull Comments run from
22 058b0118 2005-01-03 devnull to newline.
23 058b0118 2005-01-03 devnull Extra letters appended to a valid instruction are ignored.
25 058b0118 2005-01-03 devnull .LR ...line ,
26 058b0118 2005-01-03 devnull .LR line , and
28 058b0118 2005-01-03 devnull all mean the same thing.
29 058b0118 2005-01-03 devnull Arguments are interpreted as follows:
32 058b0118 2005-01-03 devnull If an instruction requires no arguments, the rest of the line is ignored.
35 058b0118 2005-01-03 devnull If it requires a string argument, then all the line
36 058b0118 2005-01-03 devnull after the first field separator is passed as argument.
37 058b0118 2005-01-03 devnull Quote marks may be used to preserve leading blanks.
38 058b0118 2005-01-03 devnull Strings may include newlines represented as
39 058b0118 2005-01-03 devnull .LR \en .
42 058b0118 2005-01-03 devnull Between numeric arguments alphabetic characters and
43 058b0118 2005-01-03 devnull punctuation marks are ignored.
46 058b0118 2005-01-03 devnull line from 5 6 to 7 8
47 058b0118 2005-01-03 devnull draws a line from (5, 6) to (7, 8).
50 058b0118 2005-01-03 devnull Instructions with numeric arguments remain in effect until
51 058b0118 2005-01-03 devnull a new instruction is read.
52 058b0118 2005-01-03 devnull Such commands may spill over many lines. Thus
53 058b0118 2005-01-03 devnull the following sequence will draw a polygon
54 058b0118 2005-01-03 devnull with vertices
55 058b0118 2005-01-03 devnull (4.5, 6.77), (5.8, 5.6), (7.8, 4.55), and (10.0, 3.6).
58 058b0118 2005-01-03 devnull move 4.5 6.77
59 058b0118 2005-01-03 devnull vec 5.8, 5.6 7.8
60 058b0118 2005-01-03 devnull 4.55 10.0, 3.6 4.5, 6.77
63 058b0118 2005-01-03 devnull The instructions are executed in order.
64 058b0118 2005-01-03 devnull The last designated point in a
65 058b0118 2005-01-03 devnull .BR line ", " move ", " rmove ,
66 058b0118 2005-01-03 devnull .BR vec ", " rvec ", " arc ,
69 058b0118 2005-01-03 devnull command becomes the `current point'
70 058b0118 2005-01-03 devnull .RI ( X,Y )
71 058b0118 2005-01-03 devnull for the next command.
72 058b0118 2005-01-03 devnull .SS "Open & Close"
75 058b0118 2005-01-03 devnull .BI o " string"
76 058b0118 2005-01-03 devnull Open plotting device.
78 058b0118 2005-01-03 devnull .IR troff ,
79 058b0118 2005-01-03 devnull .I string
80 058b0118 2005-01-03 devnull specifies the size of the plot
81 058b0118 2005-01-03 devnull (default is
82 058b0118 2005-01-03 devnull .LR 6i ).
85 058b0118 2005-01-03 devnull Close plotting device.
87 058b0118 2005-01-03 devnull .SS "Basic Plotting Commands"
91 058b0118 2005-01-03 devnull Start another frame of output.
93 058b0118 2005-01-03 devnull .BI m " x y"
94 058b0118 2005-01-03 devnull (move) Current point becomes
95 058b0118 2005-01-03 devnull .I "x y."
97 058b0118 2005-01-03 devnull .BI rm " dx dy"
98 058b0118 2005-01-03 devnull Current point becomes
99 058b0118 2005-01-03 devnull .I "X+dx Y+dy."
101 058b0118 2005-01-03 devnull .BI poi " x y"
102 058b0118 2005-01-03 devnull Plot the point
103 058b0118 2005-01-03 devnull .I "x y"
104 058b0118 2005-01-03 devnull and make it the current point.
106 058b0118 2005-01-03 devnull .BI v " x y"
107 058b0118 2005-01-03 devnull Draw a vector from the current point to
108 058b0118 2005-01-03 devnull .I "x y."
110 058b0118 2005-01-03 devnull .BI rv " dx dy"
111 058b0118 2005-01-03 devnull Draw vector from current point to
112 058b0118 2005-01-03 devnull .RI X + dx
113 058b0118 2005-01-03 devnull .RI Y + dy
115 058b0118 2005-01-03 devnull .BI li " x1 y1 x2 y2"
116 058b0118 2005-01-03 devnull Draw a line from
117 058b0118 2005-01-03 devnull .I "x1 y1"
119 058b0118 2005-01-03 devnull .I "x2 y2."
120 058b0118 2005-01-03 devnull Make the current point
121 058b0118 2005-01-03 devnull .I "x2 y2."
123 058b0118 2005-01-03 devnull .BI t " string"
124 058b0118 2005-01-03 devnull Place the
125 058b0118 2005-01-03 devnull .I string
126 058b0118 2005-01-03 devnull so that its
127 058b0118 2005-01-03 devnull first character is centered on the current point (default).
129 058b0118 2005-01-03 devnull .I string
130 058b0118 2005-01-03 devnull begins with
132 058b0118 2005-01-03 devnull .RL ( \eR ),
133 058b0118 2005-01-03 devnull it is centered (right-adjusted) on the current point.
134 058b0118 2005-01-03 devnull A backslash at the beginning of the string may
135 058b0118 2005-01-03 devnull be escaped with another backslash.
137 058b0118 2005-01-03 devnull .BI a " x1 y1 x2 y2 xc yc r"
138 058b0118 2005-01-03 devnull Draw a circular arc from
139 058b0118 2005-01-03 devnull .I "x1 y1"
141 058b0118 2005-01-03 devnull .I "x2 y2"
142 058b0118 2005-01-03 devnull with center
143 058b0118 2005-01-03 devnull .I "xc yc"
144 058b0118 2005-01-03 devnull and radius
146 058b0118 2005-01-03 devnull If the radius is positive, the arc is drawn counterclockwise;
147 058b0118 2005-01-03 devnull negative, clockwise.
148 058b0118 2005-01-03 devnull The starting point is exact but the ending point is approximate.
150 058b0118 2005-01-03 devnull .BI ci " xc yc r"
151 058b0118 2005-01-03 devnull Draw a circle centered at
152 058b0118 2005-01-03 devnull .I "xc yc"
153 058b0118 2005-01-03 devnull with radius
155 058b0118 2005-01-03 devnull If the range and frame parameters do not specify a square,
156 058b0118 2005-01-03 devnull the `circle' will be elliptical.
158 058b0118 2005-01-03 devnull .BI di " xc yc r"
159 058b0118 2005-01-03 devnull Draw a disc centered at
160 058b0118 2005-01-03 devnull .I "xc yc"
161 058b0118 2005-01-03 devnull with radius
163 058b0118 2005-01-03 devnull using the filling color (see
164 058b0118 2005-01-03 devnull .B cfill
167 058b0118 2005-01-03 devnull .BI bo " x1 y1 x2 y2"
168 058b0118 2005-01-03 devnull Draw a box with lower left corner at
169 058b0118 2005-01-03 devnull .I "x1 y1"
170 058b0118 2005-01-03 devnull and upper right corner at
171 058b0118 2005-01-03 devnull .I "x2 y2."
173 058b0118 2005-01-03 devnull .BI sb " x1 y1 x2 y2"
174 058b0118 2005-01-03 devnull Draw a solid box with lower left corner at
175 058b0118 2005-01-03 devnull .I "x1 y1"
176 058b0118 2005-01-03 devnull and upper right corner at
177 058b0118 2005-01-03 devnull .I "x2 y2"
178 058b0118 2005-01-03 devnull using the filling color (see
179 058b0118 2005-01-03 devnull .B cfill
182 058b0118 2005-01-03 devnull .BI par " x1 y1 x2 y2 xg yg"
183 058b0118 2005-01-03 devnull Draw a parabola from
184 058b0118 2005-01-03 devnull .I "x1 y1"
186 058b0118 2005-01-03 devnull .I "x2 y2"
187 058b0118 2005-01-03 devnull `guided' by
188 058b0118 2005-01-03 devnull .I "xg yg."
189 058b0118 2005-01-03 devnull The parabola passes through the midpoint of the line joining
190 058b0118 2005-01-03 devnull .I "xg yg"
191 058b0118 2005-01-03 devnull with the midpoint of the line
193 058b0118 2005-01-03 devnull .I "x1 y1"
195 058b0118 2005-01-03 devnull .I "x2 y2"
196 058b0118 2005-01-03 devnull and is tangent to the lines from
197 058b0118 2005-01-03 devnull .I "xg yg"
198 058b0118 2005-01-03 devnull to the endpoints.
200 058b0118 2005-01-03 devnull .BI "pol { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI"
201 058b0118 2005-01-03 devnull Draw polygons with vertices
202 058b0118 2005-01-03 devnull .I "x1 y1 ... xn yn"
204 058b0118 2005-01-03 devnull .I "X1 Y1 ... Xm Ym."
205 058b0118 2005-01-03 devnull If only one polygon is specified, the inner brackets are
206 058b0118 2005-01-03 devnull not needed.
208 058b0118 2005-01-03 devnull .BI "fi { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI"
209 058b0118 2005-01-03 devnull Fill a polygon.
210 058b0118 2005-01-03 devnull The arguments are the same as those for
212 058b0118 2005-01-03 devnull except that the first vertex is automatically repeated to
213 058b0118 2005-01-03 devnull close each polygon.
214 058b0118 2005-01-03 devnull The polygons do not have to be connected.
215 058b0118 2005-01-03 devnull Enclosed polygons appear as holes.
217 058b0118 2005-01-03 devnull .BI "sp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
218 058b0118 2005-01-03 devnull Draw a parabolic spline guided by
219 058b0118 2005-01-03 devnull .I "x1 y1 ... xn yn"
220 058b0118 2005-01-03 devnull with simple endpoints.
222 058b0118 2005-01-03 devnull .BI "fsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
223 058b0118 2005-01-03 devnull Draw a parabolic spline guided by
224 058b0118 2005-01-03 devnull .I "x1 y1 ... xn yn"
225 058b0118 2005-01-03 devnull with double first endpoint.
227 058b0118 2005-01-03 devnull .BI "lsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
228 058b0118 2005-01-03 devnull Draw a parabolic spline guided by
229 058b0118 2005-01-03 devnull .I "x1 y1 ... xn yn"
230 058b0118 2005-01-03 devnull with double last endpoint.
232 058b0118 2005-01-03 devnull .BI "dsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
233 058b0118 2005-01-03 devnull Draw a parabolic spline guided by
234 058b0118 2005-01-03 devnull .I "x1 y1 ... xn yn"
235 058b0118 2005-01-03 devnull with double endpoints.
237 058b0118 2005-01-03 devnull .BI "csp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
239 058b0118 2005-01-03 devnull .BI in " filename"
240 058b0118 2005-01-03 devnull (include) Take commands from
241 058b0118 2005-01-03 devnull .IR filename .
243 058b0118 2005-01-03 devnull .BI de " string " { " commands " }
245 058b0118 2005-01-03 devnull .I string
247 058b0118 2005-01-03 devnull .IR commands .
249 058b0118 2005-01-03 devnull .BI ca " string scale"
250 058b0118 2005-01-03 devnull Invoke commands defined as
251 058b0118 2005-01-03 devnull .I string
252 058b0118 2005-01-03 devnull applying
253 058b0118 2005-01-03 devnull .I scale
254 058b0118 2005-01-03 devnull to all coordinates.
256 058b0118 2005-01-03 devnull .SS "Commands Controlling the Environment"
259 058b0118 2005-01-03 devnull .BI co " string"
260 058b0118 2005-01-03 devnull Use color given by first character of
261 058b0118 2005-01-03 devnull .IR string ,
263 058b0118 2005-01-03 devnull .BR red ,
264 058b0118 2005-01-03 devnull .BR yellow ,
265 058b0118 2005-01-03 devnull .BR green ,
266 058b0118 2005-01-03 devnull .BR blue ,
267 058b0118 2005-01-03 devnull .BR cyan ,
268 058b0118 2005-01-03 devnull .BR magenta ,
269 058b0118 2005-01-03 devnull .BR white ,
271 058b0118 2005-01-03 devnull .BR kblack .
273 c3674de4 2005-01-11 devnull .I string
274 c3674de4 2005-01-11 devnull begins with a digit, it is taken to be
275 c3674de4 2005-01-11 devnull a 32-bit number specifying 8 bit each of red, green, blue, and alpha.
276 c3674de4 2005-01-11 devnull For example,
277 c3674de4 2005-01-11 devnull .B 0xFFFF00FF
278 c3674de4 2005-01-11 devnull denotes solid yellow.
280 058b0118 2005-01-03 devnull .BI pe " string"
282 058b0118 2005-01-03 devnull .I string
283 058b0118 2005-01-03 devnull as the style for drawing lines.
284 058b0118 2005-01-03 devnull The available pen styles are:
285 058b0118 2005-01-03 devnull .BR solid ,
286 058b0118 2005-01-03 devnull .BR dott [ed],
287 058b0118 2005-01-03 devnull .BR short ,
288 058b0118 2005-01-03 devnull .BR long ,
289 058b0118 2005-01-03 devnull .BR dotd [ashed] ,
290 058b0118 2005-01-03 devnull .BR cdash ,
291 058b0118 2005-01-03 devnull .BR ddash
293 058b0118 2005-01-03 devnull .BI cf " string"
294 058b0118 2005-01-03 devnull Color for filling (see
295 058b0118 2005-01-03 devnull .BR co ,
298 058b0118 2005-01-03 devnull .BI ra " x1 y1 x2 y2"
299 058b0118 2005-01-03 devnull The data will fall between
300 058b0118 2005-01-03 devnull .I "x1 y1"
302 058b0118 2005-01-03 devnull .I "x2 y2."
303 058b0118 2005-01-03 devnull The plot will be magnified or reduced to fit
304 058b0118 2005-01-03 devnull the device as closely as possible.
306 058b0118 2005-01-03 devnull Range settings that exactly fill the plotting area
307 058b0118 2005-01-03 devnull with unity scaling appear below for
308 058b0118 2005-01-03 devnull devices supported by the filters of
309 058b0118 2005-01-03 devnull .IR plot (1).
310 058b0118 2005-01-03 devnull The upper limit is just outside the plotting area.
311 058b0118 2005-01-03 devnull In every case the plotting area is taken to be square;
312 058b0118 2005-01-03 devnull points outside may be displayable on
313 058b0118 2005-01-03 devnull devices with nonsquare faces.
315 058b0118 2005-01-03 devnull .BI fr " px1 py1 px2 py2"
316 058b0118 2005-01-03 devnull Plot the data in the fraction of the display
317 058b0118 2005-01-03 devnull specified by
318 058b0118 2005-01-03 devnull .I "px1 py1"
319 058b0118 2005-01-03 devnull for lower left corner
321 058b0118 2005-01-03 devnull .I "px2 py2"
322 058b0118 2005-01-03 devnull for upper right corner.
324 058b0118 2005-01-03 devnull .L frame .5 0 1. .5
325 058b0118 2005-01-03 devnull plots in the lower right
326 058b0118 2005-01-03 devnull quadrant of the display;
327 058b0118 2005-01-03 devnull .L frame 0. 1. 1. 0.
328 058b0118 2005-01-03 devnull uses the whole display but
329 058b0118 2005-01-03 devnull inverts the
331 058b0118 2005-01-03 devnull coordinates.
334 058b0118 2005-01-03 devnull Save the current environment, and move to a new one.
335 058b0118 2005-01-03 devnull The new environment inherits the old one.
336 058b0118 2005-01-03 devnull There are 7 levels.
339 058b0118 2005-01-03 devnull Restore previous environment.
341 058b0118 2005-01-03 devnull .SH "SEE ALSO"
342 058b0118 2005-01-03 devnull .IR plot (1),
343 058b0118 2005-01-03 devnull .IR graph (1)