plot(S)                        6 January 1993                        plot(S)


 Name

    plot - graphics interface subroutines

 Syntax


    cc  . . .  -lplot


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

    int box(x0, y0, x1, y1)
    int x0, y0, x1, y1;

    int circle(x, y, r)
    int x, y, r;

    int closepl()

    int cont(x, y)
    int x, y;

    int erase()

    int label(s)
    char *s;

    int line(x1, y1, x2, y2)
    int x1, y1, x2, y2;

    int linemod(s)
    char *s;

    int move(x, y)
    int x, y;

    int openpl()

    int point(x, y)
    int x, y;

    int space(x0, y0, x1, y1)
    int x0, y0, x1, y1;


 Description

    These subroutines generate graphic output in a relatively device-
    independent manner.  space must be used before any of these functions to
    declare the amount of space necessary (see plot(FP)).  openpl must be
    used before any of the others to open the device for writing.  closepl
    flushes the output.

    box draws a box using the four coordinates specified as arguments.

    circle draws a circle of radius r with center at the point (x, y).

    arc draws an arc of a circle with center at the point (x, y) between the
    points (x0, y0) and (x1, y1).

    String arguments to label and linemod are terminated by nulls and do not
    contain new-lines.

    See plot(FP) for a description of the effect of the remaining functions.

    The library files listed below provide several flavors of these routines.

 Return value

    Even though all routines have integer retun values, no meaningful value
    is returned.

 Files


    /usr/lib/libplot.a   produces output for tplot(ADM) filters
    /usr/lib/lib300.a    for DASI 300
    /usr/lib/lib300s.a   for DASI 300s
    /usr/lib/lib450.a    for DASI 450
    /usr/lib/lib4014.a   for TEKTRONIX 4014


 Warnings

    To compile a program containing these functions in file.c, it is neces-
    sary to use:

       cc file.c -lplot

    In order to execute it, it is necessary to use:

       a.out | tplot

    Since the plot routines use the stdio.h header file, programs that do not
    use standard I/O are increased in size more than might be expected.

 See also

    graph(ADM), plot(FP), stat(FP), tplot(ADM)

 Standards conformance

    The plot package is not part of any currently supported standard; it is
    an extension of AT&T System V provided by the Santa Cruz Operation.