3 plot \- graphics interface
5 Files of this format are interpreted by
7 to draw graphics on the screen.
14 Arguments are delimited by spaces, tabs, or commas.
15 Numbers may be floating point.
16 Punctuation marks (except
19 spaces, and tabs at the beginning of lines are ignored.
23 Extra letters appended to a valid instruction are ignored.
28 all mean the same thing.
29 Arguments are interpreted as follows:
32 If an instruction requires no arguments, the rest of the line is ignored.
35 If it requires a string argument, then all the line
36 after the first field separator is passed as argument.
37 Quote marks may be used to preserve leading blanks.
38 Strings may include newlines represented as
42 Between numeric arguments alphabetic characters and
43 punctuation marks are ignored.
47 draws a line from (5, 6) to (7, 8).
50 Instructions with numeric arguments remain in effect until
51 a new instruction is read.
52 Such commands may spill over many lines. Thus
53 the following sequence will draw a polygon
55 (4.5, 6.77), (5.8, 5.6), (7.8, 4.55), and (10.0, 3.6).
60 4.55 10.0, 3.6 4.5, 6.77
63 The instructions are executed in order.
64 The last designated point in a
65 .BR line ", " move ", " rmove ,
66 .BR vec ", " rvec ", " arc ,
69 command becomes the `current point'
80 specifies the size of the plot
85 Close plotting device.
87 .SS "Basic Plotting Commands"
91 Start another frame of output.
94 (move) Current point becomes
104 and make it the current point.
107 Draw a vector from the current point to
111 Draw vector from current point to
115 .BI li " x1 y1 x2 y2"
120 Make the current point
127 first character is centered on the current point (default).
133 it is centered (right-adjusted) on the current point.
134 A backslash at the beginning of the string may
135 be escaped with another backslash.
137 .BI a " x1 y1 x2 y2 xc yc r"
138 Draw a circular arc from
146 If the radius is positive, the arc is drawn counterclockwise;
148 The starting point is exact but the ending point is approximate.
151 Draw a circle centered at
155 If the range and frame parameters do not specify a square,
156 the `circle' will be elliptical.
159 Draw a disc centered at
163 using the filling color (see
167 .BI bo " x1 y1 x2 y2"
168 Draw a box with lower left corner at
170 and upper right corner at
173 .BI sb " x1 y1 x2 y2"
174 Draw a solid box with lower left corner at
176 and upper right corner at
178 using the filling color (see
182 .BI par " x1 y1 x2 y2 xg yg"
189 The parabola passes through the midpoint of the line joining
191 with the midpoint of the line
196 and is tangent to the lines from
200 .BI "pol { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI"
201 Draw polygons with vertices
204 .I "X1 Y1 ... Xm Ym."
205 If only one polygon is specified, the inner brackets are
208 .BI "fi { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI"
210 The arguments are the same as those for
212 except that the first vertex is automatically repeated to
214 The polygons do not have to be connected.
215 Enclosed polygons appear as holes.
217 .BI "sp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
218 Draw a parabolic spline guided by
220 with simple endpoints.
222 .BI "fsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
223 Draw a parabolic spline guided by
225 with double first endpoint.
227 .BI "lsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
228 Draw a parabolic spline guided by
230 with double last endpoint.
232 .BI "dsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
233 Draw a parabolic spline guided by
235 with double endpoints.
237 .BI "csp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fL} }\fI"
240 (include) Take commands from
243 .BI de " string " { " commands " }
249 .BI ca " string scale"
250 Invoke commands defined as
256 .SS "Commands Controlling the Environment"
260 Use color given by first character of
274 begins with a digit, it is taken to be
275 a 32-bit number specifying 8 bit each of red, green, blue, and alpha.
278 denotes solid yellow.
283 as the style for drawing lines.
284 The available pen styles are:
294 Color for filling (see
298 .BI ra " x1 y1 x2 y2"
299 The data will fall between
303 The plot will be magnified or reduced to fit
304 the device as closely as possible.
306 Range settings that exactly fill the plotting area
307 with unity scaling appear below for
308 devices supported by the filters of
310 The upper limit is just outside the plotting area.
311 In every case the plotting area is taken to be square;
312 points outside may be displayable on
313 devices with nonsquare faces.
315 .BI fr " px1 py1 px2 py2"
316 Plot the data in the fraction of the display
319 for lower left corner
322 for upper right corner.
325 plots in the lower right
326 quadrant of the display;
328 uses the whole display but
334 Save the current environment, and move to a new one.
335 The new environment inherits the old one.
339 Restore previous environment.
