1 058b0118 2005-01-03 devnull .TH PLOT 7
  2 058b0118 2005-01-03 devnull .SH NAME
  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.
  8 058b0118 2005-01-03 devnull A
  9 058b0118 2005-01-03 devnull .I plot
 10 058b0118 2005-01-03 devnull file is a
 11 058b0118 2005-01-03 devnull .SM UTF
 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 
 17 058b0118 2005-01-03 devnull .LR : )
 18 058b0118 2005-01-03 devnull ,
 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  
 21 058b0118 2005-01-03 devnull .L :
 22 058b0118 2005-01-03 devnull to newline.
 23 058b0118 2005-01-03 devnull Extra letters appended to a valid instruction are ignored.
 24 058b0118 2005-01-03 devnull Thus
 25 058b0118 2005-01-03 devnull .LR ...line ,
 26 058b0118 2005-01-03 devnull .LR line , and 
 27 058b0118 2005-01-03 devnull .L li
 28 058b0118 2005-01-03 devnull all mean the same thing.
 29 058b0118 2005-01-03 devnull Arguments are interpreted as follows:
 30 058b0118 2005-01-03 devnull .TP
 31 058b0118 2005-01-03 devnull 1.
 32 058b0118 2005-01-03 devnull If an instruction requires no arguments, the rest of the line is ignored.
 33 058b0118 2005-01-03 devnull .TP
 34 058b0118 2005-01-03 devnull 2.
 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 .
 40 058b0118 2005-01-03 devnull .TP
 41 058b0118 2005-01-03 devnull 3.
 42 058b0118 2005-01-03 devnull Between numeric arguments alphabetic characters and
 43 058b0118 2005-01-03 devnull punctuation marks are ignored.
 44 058b0118 2005-01-03 devnull Thus
 45 058b0118 2005-01-03 devnull .L
 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).
 48 058b0118 2005-01-03 devnull .TP
 49 058b0118 2005-01-03 devnull 4.
 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).
 56 058b0118 2005-01-03 devnull .IP
 57 058b0118 2005-01-03 devnull .EX
 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
 61 058b0118 2005-01-03 devnull .EE
 62 058b0118 2005-01-03 devnull .PP
 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 ,
 67 058b0118 2005-01-03 devnull or
 68 058b0118 2005-01-03 devnull .B point
 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"
 73 058b0118 2005-01-03 devnull .PD0
 74 058b0118 2005-01-03 devnull .TP 10
 75 058b0118 2005-01-03 devnull .BI o " string"
 76 058b0118 2005-01-03 devnull Open plotting device.
 77 058b0118 2005-01-03 devnull For 
 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 ).
 83 058b0118 2005-01-03 devnull .TP 10
 84 058b0118 2005-01-03 devnull .B cl
 85 058b0118 2005-01-03 devnull Close plotting device.
 86 058b0118 2005-01-03 devnull .PD
 87 058b0118 2005-01-03 devnull .SS "Basic Plotting Commands"
 88 058b0118 2005-01-03 devnull .PD0
 89 058b0118 2005-01-03 devnull .TP 10
 90 058b0118 2005-01-03 devnull .B e
 91 058b0118 2005-01-03 devnull Start another frame of output.
 92 058b0118 2005-01-03 devnull .TP 10
 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."
 96 058b0118 2005-01-03 devnull .TP 10
 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."
100 058b0118 2005-01-03 devnull .TP 10
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.
105 058b0118 2005-01-03 devnull .TP 10
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."
109 058b0118 2005-01-03 devnull .TP 10
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
114 058b0118 2005-01-03 devnull .TP 10
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"
118 058b0118 2005-01-03 devnull to
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."
122 058b0118 2005-01-03 devnull .TP 10
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).
128 058b0118 2005-01-03 devnull If
129 058b0118 2005-01-03 devnull .I string
130 058b0118 2005-01-03 devnull begins with
131 058b0118 2005-01-03 devnull .L \eC
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.
136 058b0118 2005-01-03 devnull .TP 10
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"
140 058b0118 2005-01-03 devnull to
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
145 058b0118 2005-01-03 devnull .IR r .
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.
149 058b0118 2005-01-03 devnull .TP 10
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
154 058b0118 2005-01-03 devnull .IR r .
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.
157 058b0118 2005-01-03 devnull .TP 10
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
162 058b0118 2005-01-03 devnull .I r
163 058b0118 2005-01-03 devnull using the filling color (see 
164 058b0118 2005-01-03 devnull .B cfill
165 058b0118 2005-01-03 devnull below).
166 058b0118 2005-01-03 devnull .TP 10
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."
172 058b0118 2005-01-03 devnull .TP 10
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
180 058b0118 2005-01-03 devnull below).
181 058b0118 2005-01-03 devnull .TP 10
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"
185 058b0118 2005-01-03 devnull to
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
192 058b0118 2005-01-03 devnull joining
193 058b0118 2005-01-03 devnull .I "x1 y1"
194 058b0118 2005-01-03 devnull and
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.
199 058b0118 2005-01-03 devnull .TP 10
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"
203 058b0118 2005-01-03 devnull and
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.
207 058b0118 2005-01-03 devnull .TP 10
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
211 058b0118 2005-01-03 devnull .B pol
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.
216 058b0118 2005-01-03 devnull .TP 10
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.
221 058b0118 2005-01-03 devnull .TP 10
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.
226 058b0118 2005-01-03 devnull .TP 10
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.
231 058b0118 2005-01-03 devnull .TP 10
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.
236 058b0118 2005-01-03 devnull .TP 10
237 058b0118 2005-01-03 devnull .BI "csp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
238 058b0118 2005-01-03 devnull .TP 10
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 .
242 058b0118 2005-01-03 devnull .TP 10
243 058b0118 2005-01-03 devnull .BI de " string " { " commands " }
244 058b0118 2005-01-03 devnull Define
245 058b0118 2005-01-03 devnull .I string
246 058b0118 2005-01-03 devnull as
247 058b0118 2005-01-03 devnull .IR commands .
248 058b0118 2005-01-03 devnull .TP 10
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.
255 058b0118 2005-01-03 devnull .PD
256 058b0118 2005-01-03 devnull .SS "Commands Controlling the Environment"
257 058b0118 2005-01-03 devnull .PD0
258 058b0118 2005-01-03 devnull .TP 10
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 ,
262 058b0118 2005-01-03 devnull one of
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 ,
270 058b0118 2005-01-03 devnull and
271 058b0118 2005-01-03 devnull .BR kblack .
272 c3674de4 2005-01-11 devnull If
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.
279 058b0118 2005-01-03 devnull .TP 10
280 058b0118 2005-01-03 devnull .BI pe " string"
281 058b0118 2005-01-03 devnull Use
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
292 058b0118 2005-01-03 devnull .TP 10
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 ,
296 058b0118 2005-01-03 devnull above).
297 058b0118 2005-01-03 devnull .TP 10
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"
301 058b0118 2005-01-03 devnull and
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.
305 058b0118 2005-01-03 devnull .IP
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.
314 058b0118 2005-01-03 devnull .TP 10
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
320 058b0118 2005-01-03 devnull and
321 058b0118 2005-01-03 devnull .I "px2 py2"
322 058b0118 2005-01-03 devnull for upper right corner.
323 058b0118 2005-01-03 devnull Thus  
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
330 058b0118 2005-01-03 devnull .I y
331 058b0118 2005-01-03 devnull coordinates.
332 058b0118 2005-01-03 devnull .TP 10
333 058b0118 2005-01-03 devnull .B sa
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.
337 058b0118 2005-01-03 devnull .TP 10
338 058b0118 2005-01-03 devnull .B re
339 058b0118 2005-01-03 devnull Restore previous environment.
340 058b0118 2005-01-03 devnull .PD
341 058b0118 2005-01-03 devnull .SH "SEE ALSO"
342 058b0118 2005-01-03 devnull .IR plot (1), 
343 d32deab1 2020-08-16 rsc .MR graph (1)