NAME

       POINTS - draws a marker at each of a series of specified positions in the user coordinate
       system.  The markers can also be connected by drawing lines between them.

SYNOPSIS

       CALL POINTS (PX,PY,NP,IC,IL)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_points (float *px, float *py, int np, int ic, int il)

DESCRIPTION

       PX          (an input array of type REAL) defines the X user coordinates where a series of
                   NP markers are to be drawn.

       PY          (an input array of type REAL) defines the Y user coordinates where a series of
                   NP markers are to be drawn.

       NP          (an input expression of type INTEGER) specifies the number of markers to be
                   drawn.

       IC          (an input expression of type INTEGER) describes the type of marker to be
                   drawn, as follows:

                   IC < 0 - draw a GKS polymarker of type -IC, as follows:

                     -1  requests a dot (.),

                     -2  requests a plus (+),

                     -3  requests an asterisk (*),

                     -4  requests a circle (o), and

                     -5  requests a cross (x).

                   The polymarker size and color can be set by calling the GKS routines GSMKSC,
                   GSCR, and GSPMCI before calling POINTS.

                   IC = 0 - draw a dot (.).  Effect is the same as IC = -1.

                   IC > 0 - draw the FORTRAN77 character CHAR(IC).

                   In this case, the GKS routine GTX is used to draw the specified character
                   CHAR(IC) at each of the NP points.  Each character is drawn with the
                   horizontal and vertical text alignment centered at the specified point with a
                   call to the GKS routine GSTXAL.  The horizontal and vertical text alignment
                   parameters are then restored to their previous values.  Other text attributes
                   such as character orientation, character height, and color, can be set by
                   calling GKS text attribute setting routines before the call to the routine
                   POINTS.

       IL          (a input expression of type INTEGER) determines if the markers are to be
                   connected with line segments.

                   IL = 0 - do not connect the markers with line segments.

                   IL .NE. 0 - connect the markers with line segments.

C-BINDING DESCRIPTION

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

USAGE

       If the routine SET has not been called, or if the last call to SET specified linear
       mappings in X and Y, and the value of IC specifies a GKS polymarker, then the GKS routine
       GPM is called to draw the polymarkers.  If, in addition, IL is non-zero, the GKS routine
       GPL is called to draw the line segments.  In all other cases, NCAR Graphics routines are
       used to draw the more complicated set of graphical objects.

       Since a call to POINTS can result in subsequent calls to the GKS routines GPM or GPL,
       various polymarker and polyline attributes may need to be set before the routine POINTS is
       called.  Polymarker attributes which can be set are listed above in the DESCRIPTION
       Section.  Polyline attributes which can be set include polyline type (call GSLN), polyline
       line width (call GSLWSC), and color (call GSCR and GSPLCI).

       A call to the routine POINTS causes the SPPS polyline buffer to be flushed.  Refer to the
       man page for the routine PLOTIF.

EXAMPLES

       Use the ncargex command to see the following relevant examples: agex11, cmptra.

ACCESS

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

SEE ALSO

       Online: gpl, gsln, gslwsc, gpm, gsmk, gsmksc, gtx, gstxal, gstxp, gstxfp, gschh, gschsp,
       gschup, gschxp, gscr, gstxci, gsplci, gspmci, spps, spps_params, plotif, ngdots, point,
       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.