[unix-history] / usr / man / man5 / plot.5

.TH PLOT 5 
.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 a stream of plotting instructions.
Each instruction consists of an ASCII letter
usually followed by bytes of binary information.
The instructions are executed in order.
A point is designated by
four bytes representing
the
x and y
values;
each value
is a signed integer.
The last designated point in an
.B "l, m, n,"
or
.B p
instruction becomes the `current point'
for the next instruction.
.PP
Each of the following descriptions begins with the name
of the corresponding routine in
.IR  plot (3).
.TP 3
.B  m
move: The next four bytes give a new current point.
.TP 3
.B  n
cont: Draw a line from the current point to
the point given by the next four bytes.
See
.IR  plot (1).
.TP 3
.B  p
point: Plot the point given by the next four bytes.
.TP 3
.B  l
line: Draw a line from the point given by the next
four bytes to the point given by the following four bytes.
.TP 3
.B  t
label: Place the following ASCII string so that its
first character falls on the current point.
The string is terminated by a newline.
.TP 3
.B  a
arc:
The first four bytes give the center, the next four give the
starting point,
and the last four give the end point of a circular arc.
The least significant coordinate of the end point is
used only to determine the quadrant.
The arc is drawn counter-clockwise.
.TP 3
.B  c
circle:
The first four bytes give the center of the circle,
the next two the radius.
.TP 3
.B  e
erase: Start another frame of output.
.TP 3
.B  f
linemod: Take the following string, up to a newline,
as the style for drawing further lines.
The styles are
`dotted,'
`solid,' `longdashed,' `shortdashed,' and `dotdashed.'
Effective only in 
.I plot 4014
and
.I plot ver.
.TP 3
.B  s
space: The next four bytes give
the lower left corner of the plotting area;
the following four give the upper right corner.
The plot will be magnified or reduced to fit
the device as closely as possible.
.IP
Space 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 whose face isn't square.
.RS
.TP 10n
4014
space(0, 0, 3120, 3120);
.br
.ns
.TP 
ver
space(0, 0, 2048, 2048);
.br
.ns
.TP 
300, 300s
space(0, 0, 4096, 4096);
.br
.ns
.TP 
450
space(0, 0, 4096, 4096);
.RE
.SH "SEE ALSO"
plot(1), plot(3), graph(1)
Commit	Line	Data
e6817382 BJ	1	.TH PLOT 5
	2	.SH NAME
	3	plot \- graphics interface
	4	.SH DESCRIPTION
	5	Files of this format are produced by routines
	6	described in
	7	.IR plot (3),
	8	and are interpreted for various devices
	9	by commands described in
	10	.IR plot (1).
	11	A graphics file is a stream of plotting instructions.
	12	Each instruction consists of an ASCII letter
	13	usually followed by bytes of binary information.
	14	The instructions are executed in order.
	15	A point is designated by
	16	four bytes representing
	17	the
	18	x and y
	19	values;
	20	each value
	21	is a signed integer.
	22	The last designated point in an
	23	.B "l, m, n,"
	24	or
	25	.B p
	26	instruction becomes the `current point'
	27	for the next instruction.
	28	.PP
	29	Each of the following descriptions begins with the name
	30	of the corresponding routine in
	31	.IR plot (3).
	32	.TP 3
	33	.B m
	34	move: The next four bytes give a new current point.
	35	.TP 3
	36	.B n
	37	cont: Draw a line from the current point to
	38	the point given by the next four bytes.
	39	See
	40	.IR plot (1).
	41	.TP 3
	42	.B p
	43	point: Plot the point given by the next four bytes.
	44	.TP 3
	45	.B l
	46	line: Draw a line from the point given by the next
	47	four bytes to the point given by the following four bytes.
	48	.TP 3
	49	.B t
	50	label: Place the following ASCII string so that its
	51	first character falls on the current point.
	52	The string is terminated by a newline.
	53	.TP 3
	54	.B a
	55	arc:
	56	The first four bytes give the center, the next four give the
	57	starting point,
	58	and the last four give the end point of a circular arc.
	59	The least significant coordinate of the end point is
	60	used only to determine the quadrant.
	61	The arc is drawn counter-clockwise.
	62	.TP 3
	63	.B c
	64	circle:
65	The first four bytes give the center of the circle,
66	the next two the radius.
67	.TP 3
68	.B e
69	erase: Start another frame of output.
70	.TP 3
71	.B f
72	linemod: Take the following string, up to a newline,
73	as the style for drawing further lines.
74	The styles are
75	`dotted,'
76	`solid,' `longdashed,' `shortdashed,' and `dotdashed.'
77	Effective only in
78	.I plot 4014
79	and
80	.I plot ver.
81	.TP 3
82	.B s
83	space: The next four bytes give
84	the lower left corner of the plotting area;
85	the following four give the upper right corner.
86	The plot will be magnified or reduced to fit
87	the device as closely as possible.
88	.IP
89	Space settings that exactly fill the plotting area
90	with unity scaling appear below for
91	devices supported by the filters of
92	.IR plot (1).
93	The upper limit is just outside the plotting area.
94	In every case the plotting area is taken to be square;
95	points outside may be displayable on
96	devices whose face isn't square.
97	.RS
98	.TP 10n
99	4014
100	space(0, 0, 3120, 3120);
101	.br
102	.ns
103	.TP
104	ver
105	space(0, 0, 2048, 2048);
106	.br
107	.ns
108	.TP
109	300, 300s
110	space(0, 0, 4096, 4096);
111	.br
112	.ns
113	.TP
114	450
115	space(0, 0, 4096, 4096);
116	.RE
117	.SH "SEE ALSO"
118	plot(1), plot(3), graph(1)