NAME

       LINE - draws a line from the point (X1,Y1) to the point (X2,Y2).  The "pen" (for
       subsequent calls to FRSTPT, VECTOR, PLOTIF, and PLOTIT) is left at (X2,Y2).

SYNOPSIS

       CALL LINE (X1,Y1,X2,Y2)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_line (float x1, float y1, float x2, float y2)

DESCRIPTION

       X1          (an input expression of type REAL) defines the X user coordinate of the
                   starting point of a line segment.

       Y1          (an input expression of type REAL) defines the Y user coordinate of the
                   starting point of a line segment.

       X2          (an input expression of type REAL) defines the X user coordinate of the ending
                   point of a line segment.

       Y2          (an input expression of type REAL) defines the Y user coordinate of the ending
                   point of a line segment.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

       Polyline type, line width, and color can be set by calling the GKS routines GSLN, GSLWSC,
       GSCR, and GSPLCI before calling LINE.

       This routine flushes the SPPS polyline buffer at each line draw.  Thus, polyline
       attributes can be safely changed between successive calls.

EXAMPLES

       Use the ncargex command to see the following relevant examples: mpex07, mpex09, cbex01,
       coex01, coex03, epltch, srex01, and tgflas.

ACCESS

       To use LINE or c_line, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.

SEE ALSO

       Online: gpl, gsln, gslwsc, gscr, gsplci, spps, spps_params, frstpt, vector, plotif, curve,
       ncarg_cbind

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.