plot(3)                             CLIX                             plot(3)



  NAME

    plot - Graphics interface functions

  LIBRARY

    lib300.a

    lib300s.a

    lib4014.a

    lib450.a

    libplot.a

    libvt0.a

  SYNOPSIS

    void openpl(
      void );

    void erase(
      void );

    label(
      char *string );

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

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

    void arc(
      int x ,
      int y ,
      int x1 ,
      int y1 ,
      int x2 ,
      int y2 );

    void move(
      int NewX ,
      int NewY );



  2/94 - Intergraph Corporation                                              1

  plot(3)                             CLIX                             plot(3)



    void cont(
      int NewX ,
      int NewY );

    void point(
      int NewX ,
      int NewY );

    void linemod(
      char *linestyle );

    void space(
      int LowerLeftX ,
      int LowerLeftY ,
      int UpperRightX ,
      int UpperRightY );

    void closepl(
      void );

  PARAMETERS

    string A pointer to a NULL terminated output string not containing
           newlines

    x1, x2, y1, y2
           The x and y endpoints of the line or arc to be drawn

    x, y   The coordinates of the center of the circle or centerpoint of the
           arc

    r      The radius of the circle

    NewX, NewY
           The coordinates of the new point location or the point to which to
           continue a line

    LowerLeftX, LowerLeftY
           The coordinates of the lower left corner of the plotting area

    UpperRightX,UpperRightY
           The coordinates of the upper left corner of the plotting area

    linestyle
           A string indicating the linestyle to be used to plot from the
           current point; valid values are ``dotted'', ``solid'',
           ``longdashed'', ``shortdashed'', and ``dotdashed''.  The string
           must be null terminated.

  DESCRIPTION




  2                                              Intergraph Corporation - 2/94

  plot(3)                             CLIX                             plot(3)



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

    The erase() function starts another frame of output.

    The label() function displays the ASCII string so that its first character
    starts at the current point.

    The line() function draws a line from the point at location (x1,y1) to the
    point at location (x2,y2).

    The move() function relocates the current point to the coordinates
    (NewX,NewY).

    The cont() function continues an existing line from the location of the
    current point to the coordinates (NewX,NewY).

    The point() function draws a point at coordinate (newX,NewY)

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

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

    The linemod() function sets and resets the linestyle for line drawing.

    The space() function defines the limits of the plot area.

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

  EXAMPLES

    To draw two lines in a plot space:

    /* Define plotting area. */
    space(0, 0, 4096, 4096);
    /* Set the linestyle to dotted. */
    linemod("dotted");
    /* Draw a diagonal across the plot space. */
    line(0, 0, 4096, 4096);
    /* Continue the current line from the upper right */
    /* corner (current point) to the lower right corner. */
    cont(4096, 0);


  FILES




  2/94 - Intergraph Corporation                                              3

  plot(3)                             CLIX                             plot(3)



    $LIBDIR/libplot.a   Produces output for tplot filters

    $LIBDIR/lib300.a    For DASI 300

    $LIBDIR/lib300.a    For DASI 300s

    $LIBDIR/lib450.a    For DASI 450

    $LIBDIR/lib4014.a   For TEKTRONIX 4014

    $LIBDIR             Usually /usr/lib

  NOTES

    To compile a program containing these functions in file.c it is necessary
    to use the following command:

    cc file.c -lplot

    To execute it, it is necessary to use

    a.out | tplot

    The above functions use <stdio.h>, which causes them to increase the size
    of programs, not otherwise using standard I/O more than might be expected.

  RETURN VALUES

    None.

  RELATED INFORMATION

    Commands:  graph(1), stat(1), tplot(1)

    Files:  plot(4)



















  4                                              Intergraph Corporation - 2/94