summaryrefslogtreecommitdiff
path: root/static/unix-v10/man5/plot.5
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
commit97d5c458cfa039d857301e1ca7d5af3beb37131d (patch)
treeb460cd850d0537eb71806ba30358840377b27688 /static/unix-v10/man5/plot.5
parentb89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff)
build: Better Build System
Diffstat (limited to 'static/unix-v10/man5/plot.5')
-rw-r--r--static/unix-v10/man5/plot.5453
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)