[unix-history] / usr / src / lib / libplot / plot / plot.3

.\"	@(#)plot.3	6.3 (Berkeley) %G%
.\"
.TH PLOT 3 ""
.AT 3
.SH NAME
plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, closepl \- graphics interface
.SH SYNOPSIS
.nf
.B openpl()
.PP
.B erase()
.PP
.B label(s)
.B char s[];
.PP
.B line(x1, y1, x2, y2)
.PP
.B circle(x, y, r)
.PP
.B arc(x, y, x0, y0, x1, y1)
.PP
.B move(x, y)
.PP
.B cont(x, y)
.PP
.B point(x, y)
.PP
.B linemod(s)
.B char s[];
.PP
.B space(x0, y0, x1, y1)
.PP
.B closepl()
.fi
.PP
.ft R
.SH DESCRIPTION
These subroutines generate graphic output in a relatively
device-independent manner.  See
.IR  plot (5)
for a description of their effect.
.I Openpl
must be used before any of the others to open the device for writing.
.I Closepl
flushes the output.
.PP
String arguments to
.I label
and
.I linemod
are null-terminated, and do not contain newlines.
.PP
Various flavors of these functions exist for different output devices. 
They are obtained by the following
.IR ld (1)
options:
.TP 8n
.B \-lplot
device-independent graphics stream on standard output for 
.IR plot (1)
filters
.br
.ns
.TP
.B \-l300
GSI 300 terminal
.br
.ns
.TP
.B \-l300s
GSI 300S terminal
.br
.ns
.TP
.B \-l450
GSI 450 terminal
.br
.ns
.TP
.B \-l4013
Tektronix 4013 terminal
.br
.ns
.TP
.B \-l4014
Tektronix 4014 and 4015 terminals with the Enhanced Graphics Module (Use
.B \-l4013
for 4014's or 4015's without the Enhanced Graphics Module)
.br
.ns
.TP
.B \-lplotaed
AED 512 color graphics terminal
.br
.ns
.TP
.B \-lplotbg
BBN bitgraph graphics terminal
.br
.ns
.TP
.B \-lplotdumb
Dumb terminals without cursor addressing or line printers
.br
.ns
.TP
.B \-lplotgigi
DEC Gigi terminals
.br
.ns
.TP
.B \-lvt0
DEC vt100 terminals
.br
.ns
.TP
.B \-lplot2648
Hewlett Packard 2648 graphics terminal
.br
.ns
.TP
.B \-lplot7221
Hewlett Packard 7221 graphics terminal
.br
.ns
.TP
.B \-lplotimagen
Imagen laser printer (default 240 dots-per-inch resolution).
.PP
On many devices, it is necessary to pause after
.IR erase (),
otherwise plotting commands are lost.
The pause is normally done by the tty driver if at login time,
.I tset
found a
.I df
field in the
.IR termcap (5)
entry for the terminal.
If a pause is needed but not automatically being generated,
add
.RS
.nf
flush(stdout);
sleep(1);
.fi
.RE
after each
.IR erase ().
.SH "SEE ALSO"
plot(5), plot(1G), plot(3F), graph(1G)
Commit	Line	Data
107ca68b	1	.\" @(#)plot.3 6.3 (Berkeley) %G%
2435e21a	2	.\"
f93f9c5e	3	.TH PLOT 3 ""
2435e21a KM	4	.AT 3
2435e21a KM	5	.SH NAME
2501b1f4	6	plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, closepl \- graphics interface
2435e21a KM	7	.SH SYNOPSIS
	8	.nf
	9	.B openpl()
	10	.PP
	11	.B erase()
	12	.PP
	13	.B label(s)
	14	.B char s[];
	15	.PP
	16	.B line(x1, y1, x2, y2)
	17	.PP
	18	.B circle(x, y, r)
	19	.PP
	20	.B arc(x, y, x0, y0, x1, y1)
	21	.PP
	22	.B move(x, y)
	23	.PP
	24	.B cont(x, y)
	25	.PP
	26	.B point(x, y)
	27	.PP
	28	.B linemod(s)
	29	.B char s[];
	30	.PP
	31	.B space(x0, y0, x1, y1)
	32	.PP
	33	.B closepl()
	34	.fi
	35	.PP
	36	.ft R
	37	.SH DESCRIPTION
2501b1f4 KM	38	These subroutines generate graphic output in a relatively
2501b1f4 KM	39	device-independent manner. See
2435e21a	40	.IR plot (5)
2501b1f4	41	for a description of their effect.
2435e21a	42	.I Openpl
2501b1f4	43	must be used before any of the others to open the device for writing.
2435e21a KM	44	.I Closepl
	45	flushes the output.
	46	.PP
	47	String arguments to
	48	.I label
	49	and
	50	.I linemod
	51	are null-terminated, and do not contain newlines.
	52	.PP
2501b1f4	53	Various flavors of these functions exist for different output devices.
2435e21a KM	54	They are obtained by the following
	55	.IR ld (1)
	56	options:
	57	.TP 8n
	58	.B \-lplot
2501b1f4	59	device-independent graphics stream on standard output for
2435e21a KM	60	.IR plot (1)
	61	filters
	62	.br
	63	.ns
	64	.TP
	65	.B \-l300
	66	GSI 300 terminal
	67	.br
	68	.ns
	69	.TP
	70	.B \-l300s
	71	GSI 300S terminal
	72	.br
	73	.ns
	74	.TP
	75	.B \-l450
27b72642	76	GSI 450 terminal
2435e21a KM	77	.br
	78	.ns
	79	.TP
f93f9c5e KM	80	.B \-l4013
	81	Tektronix 4013 terminal
	82	.br
	83	.ns
	84	.TP
2435e21a	85	.B \-l4014
f93f9c5e KM	86	Tektronix 4014 and 4015 terminals with the Enhanced Graphics Module (Use
	87	.B \-l4013
	88	for 4014's or 4015's without the Enhanced Graphics Module)
27b72642 KM	89	.br
	90	.ns
	91	.TP
	92	.B \-lplotaed
	93	AED 512 color graphics terminal
	94	.br
	95	.ns
	96	.TP
	97	.B \-lplotbg
	98	BBN bitgraph graphics terminal
	99	.br
	100	.ns
	101	.TP
	102	.B \-lplotdumb
	103	Dumb terminals without cursor addressing or line printers
	104	.br
	105	.ns
	106	.TP
107ca68b	107	.B \-lplotgigi
27b72642 KM	108	DEC Gigi terminals
	109	.br
	110	.ns
	111	.TP
	112	.B \-lvt0
	113	DEC vt100 terminals
	114	.br
	115	.ns
	116	.TP
	117	.B \-lplot2648
	118	Hewlett Packard 2648 graphics terminal
	119	.br
	120	.ns
	121	.TP
	122	.B \-lplot7221
	123	Hewlett Packard 7221 graphics terminal
	124	.br
	125	.ns
	126	.TP
	127	.B \-lplotimagen
	128	Imagen laser printer (default 240 dots-per-inch resolution).
f93f9c5e KM	129	.PP
	130	On many devices, it is necessary to pause after
	131	.IR erase (),
	132	otherwise plotting commands are lost.
	133	The pause is normally done by the tty driver if at login time,
	134	.I tset
	135	found a
	136	.I df
	137	field in the
	138	.IR termcap (5)
	139	entry for the terminal.
	140	If a pause is needed but not automatically being generated,
	141	add
	142	.RS
	143	.nf
	144	flush(stdout);
	145	sleep(1);
	146	.fi
	147	.RE
	148	after each
	149	.IR erase ().
2435e21a	150	.SH "SEE ALSO"
f93f9c5e	151	plot(5), plot(1G), plot(3F), graph(1G)