NAME

       gpolyline - Draw line segments connecting a sequence of user-specified coordinate pairs

SYNOPSIS

       #include <ncarg/gks.h>

       void gpolyline(const Gpoint_list *point_list);

DESCRIPTION

       gpolyline  (Polyline) - This output primitive draws line segments connecting a sequence of user-specified
       coordinate pairs.

       point_list.num_points
                   (Gint, Input) - The number of points in the line to be drawn. Must be larger than one.

       point_list.points
                   (Gint *, Input)  -  The  X  and  Y  coordinates  (specified  in  world  coordinates)  of  the
                   point_list.num_points points to be connected by line segments.

USAGE

       Note  that  the  coordinate  pairs  must  be  in world coordinates and not user coordinates.  Among other
       things, this means that the log scaling and mirror-imaging features available via the c_set call and  the
       SPPS functions for drawing lines are not applicable here.

ACCESS

       To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries.

SEE ALSO

       Online: gset_linetype(3NCARG), gset_linewidth(3NCARG), gset_colr_rep(3NCARG), gset_line_colr_ind(3NCARG),
       ginq_linetype(3NCARG), ginq_linewidth(3NCARG), ginq_line_colr_ind(3NCARG), dashline(3NCARG), set(3NCARG),
       gks(3NCARG), ncarg_gks_cbind(3NCARG)

       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version "The Use of X/Y
       Coordinates in NCAR Graphics" SCD User Document"

COPYRIGHT

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

UNIX                                               March 1993                                  GPOLYLINE(3NCARG)