![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to plot.5 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / man5|
Return to plot.5 CVS log | Up to [Research Unix] / researchv10dc / man / man5 |
1.1 root 1: .TH PLOT 5
2: .CT 1 graphics
3: .SH NAME
4: plot \- graphics interface
5: .SH DESCRIPTION
6: Files of this format are produced by routines
7: described in
8: .IR plot (3),
9: and are interpreted for various devices
10: by commands described in
11: .IR plot (1).
12: A graphics file is an ASCII stream of
13: instruction lines.
14: Arguments are delimited by spaces, tabs, or commas.
15: Numbers may be floating point.
16: Punctuation marks (except
17: .LR : )
18: ,
19: spaces, and tabs at the beginning of lines are ignored.
20: Comments run from
21: .L :
22: to newline.
23: Extra letters appended to a valid instruction are ignored.
24: Thus
25: .LR ...line ,
26: .LR line , and
27: .L li
28: all mean the same thing.
29: Arguments are interpreted as follows:
30: .TP
31: 1.
32: If an instruction requires no arguments, the rest of the line is ignored.
33: .TP
34: 2.
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
39: .LR \en .
40: .TP
41: 3.
42: Between numeric arguments alphabetic characters and
43: punctuation marks are ignored.
44: Thus
45: .L
46: line from 5 6 to 7 8
47: draws a line from (5, 6) to (7, 8).
48: .TP
49: 4.
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
54: with vertices
55: (4.5, 6.77), (5.8, 5.6), (7.8, 4.55), and (10.0, 3.6).
56: .IP
57: .EX
58: move 4.5 6.77
59: vec 5.8, 5.6 7.8
60: 4.55 10.0, 3.6 4.5, 6.77
61: .EE
62: .PP
63: The instructions are executed in order.
64: The last designated point in a
65: .BR line ", " move ", " rmove ,
66: .BR vec ", " rvec ", " arc ,
67: or
68: .B point
69: command becomes the `current point'
70: .RI ( X,Y )
71: for the next command.
72: Each of the following descriptions
73: corresponds to a routine in
74: .IR plot (3).
75: .SS "Open & Close"
76: .PD0
77: .TP 10
78: .BI o " string"
79: Open plotting device.
80: For
81: .I troff,
82: .I string
83: specifies the size of the plot
84: (default is
85: .LR 6i. )
86: .TP 10
87: .B cl
88: Close plotting device.
89: .PD
90: .SS "Basic Plotting Commands"
91: .PD0
92: .TP 10
93: .B e
94: Start another frame of output
95: or erase the screen on CRT terminals without scroll.
96: .TP 10
97: .BI m " x y"
98: (move) Current point becomes
99: .I "x y."
100: .TP 10
101: .BI rm " dx dy"
102: Current point becomes
103: .I "X+dx Y+dy."
104: .TP 10
105: .BI poi " x y"
106: Plot the point
107: .I "x y"
108: and make it the current point.
109: .TP 10
110: .BI v " x y"
111: Draw a vector from the current point to
112: .I "x y."
113: .TP 10
114: .BI rv " dx dy"
115: Draw vector from current point to
116: .RI X + dx
117: .RI Y + dy
118: .TP 10
119: .BI li " x1 y1 x2 y2"
120: Draw a line from
121: .I "x1 y1"
122: to
123: .I "x2 y2."
124: Make the current point
125: .I "x2 y2."
126: .TP 10
127: .BI t " string"
128: Place the
129: .I string
130: so that its
131: first character is centered on the current point (default).
132: If
133: .I string
134: begins with
135: .L \eC
136: .RL ( \eR ),
137: it is centered (right-adjusted) on the current point.
138: A backslash at the beginning of the string may
139: be escaped with another backslash.
140: .TP 10
141: .BI a " x1 y1 x2 y2 xc yc r"
142: Draw a circular arc from
143: .I "x1 y1"
144: to
145: .I "x2 y2"
146: with center
147: .I "xc yc"
148: and radius
149: .I r.
150: If the radius is positive, the arc is drawn counterclockwise;
151: negative, clockwise.
152: The starting point is exact but the ending point is approximate.
153: .TP 10
154: .BI ci " xc yc r"
155: Draw a circle centered at
156: .I "xc yc"
157: with radius
158: .I r.
159: If the range and frame parameters do not specify a square,
160: the `circle' will be elliptical.
161: .TP 10
162: .BI di " xc yc r"
163: Draw a disc centered at
164: .I "xc yc"
165: with radius
166: .I r
167: using the filling color (see
168: .B cfill
169: below).
170: Only works on the 5620; on other devices
171: is the same as
172: .BR circle .
173: .TP 10
174: .BI bo " x1 y1 x2 y2"
175: Draw a box with lower left corner at
176: .I "x1 y1"
177: and upper right corner at
178: .I "x2 y2."
179: .TP 10
180: .BI sb " x1 y1 x2 y2"
181: Draw a solid box with lower left corner at
182: .I "x1 y1"
183: and upper right corner at
184: .I "x2 y2"
185: using the filling color (see
186: .B cfill
187: below).
188: .TP 10
189: .BI par " x1 y1 x2 y2 xg yg"
190: Draw a parabola from
191: .I "x1 y1"
192: to
193: .I "x2 y2"
194: `guided' by
195: .I "xg yg."
196: The parabola passes through the midpoint of the line joining
197: .I "xg yg"
198: with the midpoint of the line
199: joining
200: .I "x1 y1"
201: and
202: .I "x2 y2"
203: and is tangent to the lines from
204: .I "xg yg"
205: to the endpoints.
206: .TP 10
207: .BI "pol { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI"
208: Draw polygons with vertices
209: .I "x1 y1 ... xn yn"
210: and
211: .I "X1 Y1 ... Xm Ym."
212: If only one polygon is specified, the inner brackets are
213: not needed.
214: .TP 10
215: .BI "fi { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI"
216: Fill a polygon.
217: The arguments are the same as those for
218: .B pol
219: except that the first vertex is automatically repeated to
220: close each polygon.
221: The polygons do not have to be connected.
222: Enclosed polygons appear as holes.
223: .TP 10
224: .BI "sp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI"
225: Draw a parabolic spline guided by
226: .I "x1 y1 ... xn yn"
227: with simple endpoints.
228: .TP 10
229: .BI "fsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI"
230: Draw a parabolic spline guided by
231: .I "x1 y1 ... xn yn"
232: with double first endpoint.
233: .TP 10
234: .BI "lsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI"
235: Draw a parabolic spline guided by
236: .I "x1 y1 ... xn yn"
237: with double last endpoint.
238: .TP 10
239: .BI "dsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI"
240: Draw a parabolic spline guided by
241: .I "x1 y1 ... xn yn"
242: with double endpoints.
243: .TP 10
244: .BI "csp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI"
245: .TP 10
246: .BI in " filename"
247: (include) Take commands from
248: .I filename.
249: .TP 10
250: .BI de " string " { " commands " }
251: Define
252: .I string
253: as
254: .I commands.
255: .TP 10
256: .BI ca " string scale"
257: Invoke commands defined as
258: .I string
259: applying
260: .I scale
261: to all coordinates.
262: .PD
263: .SS "Commands Controlling the Environment"
264: .PD0
265: .TP 10
266: .BI co " string"
267: Draw lines with color
268: .I string.
269: Available colors depend on the device.
270: .I String
271: may contain definitions for several devices separated by
272: .LR / .
273: Colors possible for the various devices are:
274: .RS
275: .IP pen
276: .BR black ,
277: .BR red ,
278: .BR green ,
279: .BR blue ,
280: .BR Tblack ,
281: .BR Tred ,
282: .BR Tgreen ,
283: .B Tblue
284: (assumes default carousel,
285: .BR T =thick)
286: .br
287: .BR 1 - 8
288: (pen number)
289: .br
290: .BI S number
291: character size as % of plotting area
292: .IP troff
293: .BI F font
294: .br
295: .BI P "point size"
296: .IP 2621
297: .BI H character
298: for plotting
299: .RE
300: .PD
301: .TP 10
302: .BI pe " string"
303: Use
304: .I string
305: as the style for drawing lines.
306: Not all pen styles are implemented for all devices.
307: .I String
308: may contain definitions for several devices separated by
309: .LR / .
310: The available pen styles are:
311: .RS
312: .IP pen
313: .BR solid ,
314: .BR dott [ed],
315: .BR short ,
316: .BR long ,
317: .BR dotd [ashed] ,
318: .BR cdash ,
319: .BR ddash
320: .PD0
321: .IP 4014
322: solid ,
323: .BR dott [ed] ,
324: .BR short ,
325: .BR long ,
326: .BR dotd [ashed] ,
327: .BR ddash
328: .IP troff
329: .BR solid ,
330: .BR dash
331: only straight lines will be dashed
332: .IP 5620
333: .BI B number
334: line thickness
335: .IP 2621
336: .BI H character
337: for plotting
338: .fi
339: .PD
340: .RE
341: .TP 10
342: .BI cf " string"
343: Color for filling;
344: may contain the definitions for several devices.
345: separated by
346: .LR / .
347: The following colors are available on the specified devices:
348: .RS
349: .IP pen
350: .BR black ,
351: .BR red ,
352: .BR green ,
353: .BR blue ,
354: .BR Tblack ,
355: .BR Tred ,
356: .BR Tgreen ,
357: .BR Tblue
358: .br
359: .BR 1 - 8
360: pen number
361: .PD0
362: .IP 5620
363: .BI B texture
364: string with octal numbers for texture; see
365: .IR types (9.5).
366: The 16 words of texture should be followed by one word for the mode used by
367: .IR texture() ;
368: see
369: .IR bitblt (9.3).
370: .IP 2621
371: .BI H character
372: for filling
373: .IP All devices
374: .BI /A degrees
375: slant of shading lines
376: .br
377: .BI /G number
378: gap between shading lines (in user units)
379: .RE
380: .PD
381: .TP 10
382: .BI ra " x1 y1 x2 y2"
383: The data will fall between
384: .I "x1 y1"
385: and
386: .I "x2 y2."
387: The plot will be magnified or reduced to fit
388: the device as closely as possible.
389: .IP
390: Range settings that exactly fill the plotting area
391: with unity scaling appear below for
392: devices supported by the filters of
393: .IR plot (1).
394: The upper limit is just outside the plotting area.
395: In every case the plotting area is taken to be square;
396: points outside may be displayable on
397: devices with nonsquare faces.
398: .RS
399: .TP 10n
400: 4014
401: .L range 0. 0. 3120. 3120.
402: .br
403: .ns
404: .TP 10n
405: troff
406: .L range 0. 0. 6144. 6144.
407: .br
408: .ns
409: .TP 10n
410: 2621
411: .L range 0. 0. 22. 22.
412: .br
413: .ns
414: .TP 10n
415: 5620
416: range dependent on layer size
417: .br
418: .ns
419: .TP 10n
420: pen
421: range dependent on paper size
422: .RE
423: .TP 10
424: .BI fr " px1 py1 px2 py2"
425: Plot the data in the fraction of the display
426: specified by
427: .I "px1 py1"
428: for lower left corner
429: and
430: .I "px2 py2"
431: for upper right corner.
432: Thus
433: .L frame .5 0 1. .5
434: plots in the lower right
435: quadrant of the display;
436: .L frame 0. 1. 1. 0.
437: uses the whole display but
438: inverts the
439: .I y
440: coordinates.
441: .TP 10
442: .B sa
443: Save the current environment, and move to a new one.
444: The new environment inherits the old one.
445: There are 7 levels.
446: .TP 10
447: .B re
448: Restore previous environment.
449: .PD
450: .SH "SEE ALSO"
451: .IR plot (1),
452: .IR plot (3),
453: .IR graph (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.