[unix-history] / usr / share / man / cat5 / plot.0



PLOT(5)                       1987			  PLOT(5)


N\bNA\bAM\bME\bE
     plot - graphics interface

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     Files of this format are produced by routines described in
     _\bp_\bl_\bo_\bt(3X) and _\bp_\bl_\bo_\bt(3F), and are interpreted for various dev-
     ices by commands described in _\bp_\bl_\bo_\bt(1G).  A graphics file is
     a stream of plotting instructions.  Each instruction con-
     sists 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 l\bl,\b, m\bm,\b, n\bn,\b, a\ba,\b, or p\bp instruction becomes the
     `current point' for the next instruction.	The a\ba and c\bc
     instructions change the current point in a manner dependent
     upon the specific device.

     Each of the following descriptions begins with the name of
     the corresponding routine in _\bp_\bl_\bo_\bt(3X).

     m\bm	move: The next four bytes give a new current point.

     n\bn	cont: Draw a line from the current point to the point
	given by the next four bytes.

     p\bp	point: Plot the point given by the next four bytes.

     l\bl	line: Draw a line from the point given by the next four
	bytes to the point given by the following four bytes.

     t\bt	label: Place the following ASCII string so that its first
	character falls on the current point.  The string is ter-
	minated by a newline.

     a\ba	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 coordi-
	nate of the end point is used only to determine the qua-
	drant.	The arc is drawn counter-clockwise.

     c\bc	circle: The first four bytes give the center of the cir-
	cle, the next two the radius.

     e\be	erase: Start another frame of output.

     f\bf	linemod: Take the following string, up to a newline, as
	the style for drawing further lines.  The styles are
	`dotted,' `solid,' `longdashed,' `shortdashed,' and `dot-
	dashed.' Effective only in _\bp_\bl_\bo_\bt _\b4_\b0_\b1_\b4 and _\bp_\bl_\bo_\bt _\bv_\be_\br.

     s\bs	space: The next four bytes give the lower left corner of
	the plotting area; the following four give the upper


Printed 7/27/90               April				1


PLOT(5)                       1987			  PLOT(5)


	right corner.  The plot will be magnified or reduced to
	fit the device as closely as possible.

	Space settings that exactly fill the plotting area with
	unity scaling appear below for devices supported by the
	filters of _\bp_\bl_\bo_\bt(1G).  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 dev-
	ices whose face isn't square.

	4013	  space(0, 0, 780, 780);
	4014	  space(0, 0, 3120, 3120);
	ver	  space(0, 0, 2048, 2048);
	300, 300s space(0, 0, 4096, 4096);
	450	  space(0, 0, 4096, 4096);

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     plot(1G), plot(3X), plot(3F), graph(1G)

B\bBU\bUG\bGS\bS
     A _\bl_\ba_\bb_\be_\bl instruction immediately followed by a _\bc_\bo_\bn_\bt instruc-
     tion does the wrong thing on a 4014.


Printed 7/27/90               April				2
Commit	Line	Data
3922de1d C	1
	2
	3
	4	PLOT(5) 1987 PLOT(5)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	plot - graphics interface
	10
	11	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	12	Files of this format are produced by routines described in
	13	_\bp_\bl_\bo_\bt(3X) and _\bp_\bl_\bo_\bt(3F), and are interpreted for various dev-
	14	ices by commands described in _\bp_\bl_\bo_\bt(1G). A graphics file is
	15	a stream of plotting instructions. Each instruction con-
	16	sists of an ASCII letter usually followed by bytes of binary
	17	information. The instructions are executed in order. A
	18	point is designated by four bytes representing the x and y
	19	values; each value is a signed integer. The last designated
	20	point in an l\bl,\b, m\bm,\b, n\bn,\b, a\ba,\b, or p\bp instruction becomes the
	21	`current point' for the next instruction. The a\ba and c\bc
	22	instructions change the current point in a manner dependent
	23	upon the specific device.
	24
	25	Each of the following descriptions begins with the name of
	26	the corresponding routine in _\bp_\bl_\bo_\bt(3X).
	27
	28	m\bm move: The next four bytes give a new current point.
	29
	30	n\bn cont: Draw a line from the current point to the point
	31	given by the next four bytes.
	32
	33	p\bp point: Plot the point given by the next four bytes.
	34
	35	l\bl line: Draw a line from the point given by the next four
	36	bytes to the point given by the following four bytes.
	37
	38	t\bt label: Place the following ASCII string so that its first
	39	character falls on the current point. The string is ter-
	40	minated by a newline.
	41
	42	a\ba arc: The first four bytes give the center, the next four
	43	give the starting point, and the last four give the end
	44	point of a circular arc. The least significant coordi-
	45	nate of the end point is used only to determine the qua-
	46	drant. The arc is drawn counter-clockwise.
	47
	48	c\bc circle: The first four bytes give the center of the cir-
	49	cle, the next two the radius.
	50
	51	e\be erase: Start another frame of output.
	52
	53	f\bf linemod: Take the following string, up to a newline, as
	54	the style for drawing further lines. The styles are
	55	`dotted,' `solid,' `longdashed,' `shortdashed,' and `dot-
	56	dashed.' Effective only in _\bp_\bl_\bo_\bt _\b4_\b0_\b1_\b4 and _\bp_\bl_\bo_\bt _\bv_\be_\br.
	57
	58	s\bs space: The next four bytes give the lower left corner of
	59	the plotting area; the following four give the upper
	60
	61
	62
	63	Printed 7/27/90 April 1
	64
65
66
67
68
69
70	PLOT(5) 1987 PLOT(5)
71
72
73
74	right corner. The plot will be magnified or reduced to
75	fit the device as closely as possible.
76
77	Space settings that exactly fill the plotting area with
78	unity scaling appear below for devices supported by the
79	filters of _\bp_\bl_\bo_\bt(1G). The upper limit is just outside the
80	plotting area. In every case the plotting area is taken
81	to be square; points outside may be displayable on dev-
82	ices whose face isn't square.
83
84	4013 space(0, 0, 780, 780);
85	4014 space(0, 0, 3120, 3120);
86	ver space(0, 0, 2048, 2048);
87	300, 300s space(0, 0, 4096, 4096);
88	450 space(0, 0, 4096, 4096);
89
90	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
91	plot(1G), plot(3X), plot(3F), graph(1G)
92
93	B\bBU\bUG\bGS\bS
94	A _\bl_\ba_\bb_\be_\bl instruction immediately followed by a _\bc_\bo_\bn_\bt instruc-
95	tion does the wrong thing on a 4014.
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129	Printed 7/27/90 April 2
130
131
132