POINTS(3NCARG)

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.