diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-26 16:38:00 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-26 16:38:00 -0400 |
| commit | 97d5c458cfa039d857301e1ca7d5af3beb37131d (patch) | |
| tree | b460cd850d0537eb71806ba30358840377b27688 /static/unix-v10/man5/plot.5 | |
| parent | b89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff) | |
build: Better Build System
Diffstat (limited to 'static/unix-v10/man5/plot.5')
| -rw-r--r-- | static/unix-v10/man5/plot.5 | 453 |
1 files changed, 453 insertions, 0 deletions
diff --git a/static/unix-v10/man5/plot.5 b/static/unix-v10/man5/plot.5 new file mode 100644 index 00000000..7fde38b5 --- /dev/null +++ b/static/unix-v10/man5/plot.5 @@ -0,0 +1,453 @@ +.TH PLOT 5 +.CT 1 graphics +.SH NAME +plot \- graphics interface +.SH DESCRIPTION +Files of this format are produced by routines +described in +.IR plot (3), +and are interpreted for various devices +by commands described in +.IR plot (1). +A graphics file is an ASCII stream of +instruction lines. +Arguments are delimited by spaces, tabs, or commas. +Numbers may be floating point. +Punctuation marks (except +.LR : ) +, +spaces, and tabs at the beginning of lines are ignored. +Comments run from +.L : +to newline. +Extra letters appended to a valid instruction are ignored. +Thus +.LR ...line , +.LR line , and +.L li +all mean the same thing. +Arguments are interpreted as follows: +.TP +1. +If an instruction requires no arguments, the rest of the line is ignored. +.TP +2. +If it requires a string argument, then all the line +after the first field separator is passed as argument. +Quote marks may be used to preserve leading blanks. +Strings may include newlines represented as +.LR \en . +.TP +3. +Between numeric arguments alphabetic characters and +punctuation marks are ignored. +Thus +.L +line from 5 6 to 7 8 +draws a line from (5, 6) to (7, 8). +.TP +4. +Instructions with numeric arguments remain in effect until +a new instruction is read. +Such commands may spill over many lines. Thus +the following sequence will draw a polygon +with vertices +(4.5, 6.77), (5.8, 5.6), (7.8, 4.55), and (10.0, 3.6). +.IP +.EX +move 4.5 6.77 +vec 5.8, 5.6 7.8 +4.55 10.0, 3.6 4.5, 6.77 +.EE +.PP +The instructions are executed in order. +The last designated point in a +.BR line ", " move ", " rmove , +.BR vec ", " rvec ", " arc , +or +.B point +command becomes the `current point' +.RI ( X,Y ) +for the next command. +Each of the following descriptions +corresponds to a routine in +.IR plot (3). +.SS "Open & Close" +.PD0 +.TP 10 +.BI o " string" +Open plotting device. +For +.I troff, +.I string +specifies the size of the plot +(default is +.LR 6i. ) +.TP 10 +.B cl +Close plotting device. +.PD +.SS "Basic Plotting Commands" +.PD0 +.TP 10 +.B e +Start another frame of output +or erase the screen on CRT terminals without scroll. +.TP 10 +.BI m " x y" +(move) Current point becomes +.I "x y." +.TP 10 +.BI rm " dx dy" +Current point becomes +.I "X+dx Y+dy." +.TP 10 +.BI poi " x y" +Plot the point +.I "x y" +and make it the current point. +.TP 10 +.BI v " x y" +Draw a vector from the current point to +.I "x y." +.TP 10 +.BI rv " dx dy" +Draw vector from current point to +.RI X + dx +.RI Y + dy +.TP 10 +.BI li " x1 y1 x2 y2" +Draw a line from +.I "x1 y1" +to +.I "x2 y2." +Make the current point +.I "x2 y2." +.TP 10 +.BI t " string" +Place the +.I string +so that its +first character is centered on the current point (default). +If +.I string +begins with +.L \eC +.RL ( \eR ), +it is centered (right-adjusted) on the current point. +A backslash at the beginning of the string may +be escaped with another backslash. +.TP 10 +.BI a " x1 y1 x2 y2 xc yc r" +Draw a circular arc from +.I "x1 y1" +to +.I "x2 y2" +with center +.I "xc yc" +and radius +.I r. +If the radius is positive, the arc is drawn counterclockwise; +negative, clockwise. +The starting point is exact but the ending point is approximate. +.TP 10 +.BI ci " xc yc r" +Draw a circle centered at +.I "xc yc" +with radius +.I r. +If the range and frame parameters do not specify a square, +the `circle' will be elliptical. +.TP 10 +.BI di " xc yc r" +Draw a disc centered at +.I "xc yc" +with radius +.I r +using the filling color (see +.B cfill +below). +Only works on the 5620; on other devices +is the same as +.BR circle . +.TP 10 +.BI bo " x1 y1 x2 y2" +Draw a box with lower left corner at +.I "x1 y1" +and upper right corner at +.I "x2 y2." +.TP 10 +.BI sb " x1 y1 x2 y2" +Draw a solid box with lower left corner at +.I "x1 y1" +and upper right corner at +.I "x2 y2" +using the filling color (see +.B cfill +below). +.TP 10 +.BI par " x1 y1 x2 y2 xg yg" +Draw a parabola from +.I "x1 y1" +to +.I "x2 y2" +`guided' by +.I "xg yg." +The parabola passes through the midpoint of the line joining +.I "xg yg" +with the midpoint of the line +joining +.I "x1 y1" +and +.I "x2 y2" +and is tangent to the lines from +.I "xg yg" +to the endpoints. +.TP 10 +.BI "pol { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI" +Draw polygons with vertices +.I "x1 y1 ... xn yn" +and +.I "X1 Y1 ... Xm Ym." +If only one polygon is specified, the inner brackets are +not needed. +.TP 10 +.BI "fi { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\fP} }\fI" +Fill a polygon. +The arguments are the same as those for +.B pol +except that the first vertex is automatically repeated to +close each polygon. +The polygons do not have to be connected. +Enclosed polygons appear as holes. +.TP 10 +.BI "sp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI" +Draw a parabolic spline guided by +.I "x1 y1 ... xn yn" +with simple endpoints. +.TP 10 +.BI "fsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI" +Draw a parabolic spline guided by +.I "x1 y1 ... xn yn" +with double first endpoint. +.TP 10 +.BI "lsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI" +Draw a parabolic spline guided by +.I "x1 y1 ... xn yn" +with double last endpoint. +.TP 10 +.BI "dsp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI" +Draw a parabolic spline guided by +.I "x1 y1 ... xn yn" +with double endpoints. +.TP 10 +.BI "csp { {" "x1 y1 ... xn yn" } " ... " { "X1 Y1 ... Xm Ym\f5} }\fI" +.TP 10 +.BI in " filename" +(include) Take commands from +.I filename. +.TP 10 +.BI de " string " { " commands " } +Define +.I string +as +.I commands. +.TP 10 +.BI ca " string scale" +Invoke commands defined as +.I string +applying +.I scale +to all coordinates. +.PD +.SS "Commands Controlling the Environment" +.PD0 +.TP 10 +.BI co " string" +Draw lines with color +.I string. +Available colors depend on the device. +.I String +may contain definitions for several devices separated by +.LR / . +Colors possible for the various devices are: +.RS +.IP pen +.BR black , +.BR red , +.BR green , +.BR blue , +.BR Tblack , +.BR Tred , +.BR Tgreen , +.B Tblue +(assumes default carousel, +.BR T =thick) +.br +.BR 1 - 8 +(pen number) +.br +.BI /S number +character size as % of plotting area +.IP troff +.BI /F font +.br +.BI /P "point size" +.IP 2621 +.BI /H character +for plotting +.RE +.PD +.TP 10 +.BI pe " string" +Use +.I string +as the style for drawing lines. +Not all pen styles are implemented for all devices. +.I String +may contain definitions for several devices separated by +.LR / . +The available pen styles are: +.RS +.IP pen +.BR solid , +.BR dott [ed], +.BR short , +.BR long , +.BR dotd [ashed] , +.BR cdash , +.BR ddash +.PD0 +.IP 4014 +solid , +.BR dott [ed] , +.BR short , +.BR long , +.BR dotd [ashed] , +.BR ddash +.IP troff +.BR solid , +.BR dash +only straight lines will be dashed +.IP 5620 +.BI /B number +line thickness +.IP 2621 +.BI /H character +for plotting +.fi +.PD +.RE +.TP 10 +.BI cf " string" +Color for filling; +may contain the definitions for several devices. +separated by +.LR / . +The following colors are available on the specified devices: +.RS +.IP pen +.BR black , +.BR red , +.BR green , +.BR blue , +.BR Tblack , +.BR Tred , +.BR Tgreen , +.BR Tblue +.br +.BR 1 - 8 +pen number +.PD0 +.IP 5620 +.BI B texture +string with octal numbers for texture; see +.IR types (9.5). +The 16 words of texture should be followed by one word for the mode used by +.IR texture() ; +see +.IR bitblt (9.3). +.IP 2621 +.BI H character +for filling +.IP All devices +.BI /A degrees +slant of shading lines +.br +.BI /G number +gap between shading lines (in user units) +.RE +.PD +.TP 10 +.BI ra " x1 y1 x2 y2" +The data will fall between +.I "x1 y1" +and +.I "x2 y2." +The plot will be magnified or reduced to fit +the device as closely as possible. +.IP +Range settings that exactly fill the plotting area +with unity scaling appear below for +devices supported by the filters of +.IR plot (1). +The upper limit is just outside the plotting area. +In every case the plotting area is taken to be square; +points outside may be displayable on +devices with nonsquare faces. +.RS +.TP 10n +4014 +.L range 0. 0. 3120. 3120. +.br +.ns +.TP 10n +troff +.L range 0. 0. 6144. 6144. +.br +.ns +.TP 10n +2621 +.L range 0. 0. 22. 22. +.br +.ns +.TP 10n +5620 +range dependent on layer size +.br +.ns +.TP 10n +pen +range dependent on paper size +.RE +.TP 10 +.BI fr " px1 py1 px2 py2" +Plot the data in the fraction of the display +specified by +.I "px1 py1" +for lower left corner +and +.I "px2 py2" +for upper right corner. +Thus +.L frame .5 0 1. .5 +plots in the lower right +quadrant of the display; +.L frame 0. 1. 1. 0. +uses the whole display but +inverts the +.I y +coordinates. +.TP 10 +.B sa +Save the current environment, and move to a new one. +The new environment inherits the old one. +There are 7 levels. +.TP 10 +.B re +Restore previous environment. +.PD +.SH "SEE ALSO" +.IR plot (1), +.IR plot (3), +.IR graph (1) |
