NAME

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

SYNOPSIS

       CALL GPL (N, X, Y)

C-BINDING SYNOPSIS

       #include <ncarg/gks.h>

       void gpolyline(const Gpoint_list *point_list);

DESCRIPTION

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

       N           (Integer, Input) - The number of points in the line to be  drawn.  N  must  be
                   larger than one.

       X (N)       (Real  Array,  Input)  - The X coordinates (specified in world coordinates) of
                   the N points to be connected by line segments.

       Y (N)       (Real Array, Input) - The Y coordinates (specified in  world  coordinates)  of
                   the N 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 SET call and the SPPS functions for drawing lines are not applicable here.

ACCESS

       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.

SEE ALSO

       Online: gsln, gslwsc, gscr, gsplci, gqln, gqlwsc, gqplci, dashline, set, gpolyline

       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.