1POINTS(3NCARG)                   NCAR GRAPHICS                  POINTS(3NCARG)
2
3
4

NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       void c_points (float *px, float *py, int np, int ic, int il)
17

DESCRIPTION

19       PX          (an input array of type REAL) defines the X user
20                   coordinates where a series of NP markers are to be drawn.
21
22       PY          (an input array of type REAL) defines the Y user
23                   coordinates where a series of NP markers are to be drawn.
24
25       NP          (an input expression of type INTEGER) specifies the number
26                   of markers to be drawn.
27
28       IC          (an input expression of type INTEGER) describes the type of
29                   marker to be drawn, as follows:
30
31                   IC < 0 - draw a GKS polymarker of type -IC, as follows:
32
33                     -1  requests a dot (.),
34
35                     -2  requests a plus (+),
36
37                     -3  requests an asterisk (*),
38
39                     -4  requests a circle (o), and
40
41                     -5  requests a cross (x).
42
43                   The polymarker size and color can be set by calling the GKS
44                   routines GSMKSC, GSCR, and GSPMCI before calling POINTS.
45
46                   IC = 0 - draw a dot (.).  Effect is the same as IC = -1.
47
48                   IC > 0 - draw the FORTRAN77 character CHAR(IC).
49
50                   In this case, the GKS routine GTX is used to draw the
51                   specified character CHAR(IC) at each of the NP points.
52                   Each character is drawn with the horizontal and vertical
53                   text alignment centered at the specified point with a call
54                   to the GKS routine GSTXAL.  The horizontal and vertical
55                   text alignment parameters are then restored to their
56                   previous values.  Other text attributes such as character
57                   orientation, character height, and color, can be set by
58                   calling GKS text attribute setting routines before the call
59                   to the routine POINTS.
60
61       IL          (a input expression of type INTEGER) determines if the
62                   markers are to be connected with line segments.
63
64                   IL = 0 - do not connect the markers with line segments.
65
66                   IL .NE. 0 - connect the markers with line segments.
67

C-BINDING DESCRIPTION

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

USAGE

73       If the routine SET has not been called, or if the last call to SET
74       specified linear mappings in X and Y, and the value of IC specifies a
75       GKS polymarker, then the GKS routine GPM is called to draw the
76       polymarkers.  If, in addition, IL is non-zero, the GKS routine GPL is
77       called to draw the line segments.  In all other cases, NCAR Graphics
78       routines are used to draw the more complicated set of graphical
79       objects.
80
81       Since a call to POINTS can result in subsequent calls to the GKS
82       routines GPM or GPL, various polymarker and polyline attributes may
83       need to be set before the routine POINTS is called.  Polymarker
84       attributes which can be set are listed above in the DESCRIPTION
85       Section.  Polyline attributes which can be set include polyline type
86       (call GSLN), polyline line width (call GSLWSC), and color (call GSCR
87       and GSPLCI).
88
89       A call to the routine POINTS causes the SPPS polyline buffer to be
90       flushed.  Refer to the man page for the routine PLOTIF.
91

EXAMPLES

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

ACCESS

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

SEE ALSO

101       Online: gpl, gsln, gslwsc, gpm, gsmk, gsmksc, gtx, gstxal, gstxp,
102       gstxfp, gschh, gschsp, gschup, gschxp, gscr, gstxci, gsplci, gspmci,
103       spps, spps_params, plotif, ngdots, point, ncarg_cbind
104
105       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
106       NCAR GKS-0A Graphics
107

109       Copyright (C) 1987-2009
110       University Corporation for Atmospheric Research
111       The use of this Software is governed by a License Agreement.
112
113
114
115UNIX                              March 1993                    POINTS(3NCARG)
Impressum