xref: /original-bsd/lib/libplot/plot/plot.3 (revision c3e32dec)
Copyright (c) 1986, 1993
The Regents of the University of California. All rights reserved.

%sccs.include.proprietary.roff%

@(#)plot.3 8.1 (Berkeley) 06/04/93

PLOT 3 ""
.AT 3
NAME
plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, closepl - graphics interface
SYNOPSIS
 openpl() 

erase()

label(s) char s[];

line(x1, y1, x2, y2)

circle(x, y, r)

arc(x, y, x0, y0, x1, y1)

move(x, y)

cont(x, y)

point(x, y)

linemod(s) char s[];

space(x0, y0, x1, y1)

closepl()

DESCRIPTION
These subroutines generate graphic output in a relatively device-independent manner. See plot (5) for a description of their effect. Openpl must be used before any of the others to open the device for writing. Closepl flushes the output.

String arguments to label and linemod are null-terminated, and do not contain newlines.

Various flavors of these functions exist for different output devices. They are obtained by the following ld (1) options:

8n -lplot device-independent graphics stream on standard output for plot (1) filters

.ns

-l300 GSI 300 terminal

.ns

-l300s GSI 300S terminal

.ns

-l450 GSI 450 terminal

.ns

-l4013 Tektronix 4013 terminal

.ns

-l4014 Tektronix 4014 and 4015 terminals with the Enhanced Graphics Module (Use -l4013 for 4014's or 4015's without the Enhanced Graphics Module)

.ns

-lplotaed AED 512 color graphics terminal

.ns

-lplotbg BBN bitgraph graphics terminal

.ns

-lplotdumb Dumb terminals without cursor addressing or line printers

.ns

-lplotgigi DEC Gigi terminals

.ns

-lvt0 DEC vt100 terminals

.ns

-lplot2648 Hewlett Packard 2648 graphics terminal

.ns

-lplot7221 Hewlett Packard 7221 graphics terminal

.ns

-lplotimagen Imagen laser printer (default 240 dots-per-inch resolution).

On many devices, it is necessary to pause after erase (), otherwise plotting commands are lost. The pause is normally done by the tty driver if at login time, tset found a df field in the termcap (5) entry for the terminal. If a pause is needed but not automatically being generated, add

flush(stdout);
sleep(1);
after each erase ().
"SEE ALSO"
plot(5), plot(1G), plot(3F), graph(1G)