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

NAME

6       CPSCAE - Called repeatedly by the routine CPCICA as it executes.
7       Updates a particular element of a user's cell array.  The default
8       version of CPSCAE may be replaced by the user with a version that does
9       something different.
10

SYNOPSIS

12        CALL CPSCAE (ICRA, ICA1, ICAM, ICAN, XCPF, YCPF, XCQF,
13       + YCQF, IND1, IND2, ICAF, IAID)
14

DESCRIPTION

16       The first eight arguments of CPSCAE describe the user's cell array and
17       are taken directly from the user's call to CPCICA:
18
19       ICRA        (INTEGER array, dimensioned ICA1 by "n", where "n" is
20                   greater than or equal to the value of the argument ICAN,
21                   input/output) is the user's cell array. Generally speaking,
22                   a user version of CPSCAE should only reset the value of the
23                   single element ICRA(IND1,IND2).
24
25       ICA1        (INTEGER, input) is the first dimension of the FORTRAN
26                   array ICRA, which contains the user's cell array.
27
28       ICAM        (INTEGER, input) is the first dimension of the user's cell
29                   array.
30
31       ICAN        (INTEGER, input) is the second dimension of the user's cell
32                   array.
33
34       XCPF and YCPF
35                   (REAL, input) are the coordinates, in the fractional
36                   coordinate system, of a point P. P is the point at that
37                   corner of the rectangular area into which the cell array
38                   maps that corresponds to the cell (1,1).
39
40       XCQF and YCQF
41                   (REAL, input) are the coordinates, in the fractional
42                   coordinate system, of a point Q. Q is the point at that
43                   corner of the rectangular area into which the cell array
44                   maps that corresponds to the cell (ICAM,ICAN).
45
46       IND1 and IND2
47                   (INTEGER, input) are the indices of an element in the cell
48                   array that is to be reset.
49
50       ICAF        (INTEGER, input) is the value of the internal parameter
51                   'CAF', which will be a negative integer (because, when
52                   'CAF' is greater than or equal to zero, the routine CPSCAE
53                   is not called). Different values of 'CAF' may be used in a
54                   user version of CPSCAE to select different schemes for
55                   picking color indices.
56
57       IAID        (INTEGER, input) is the value of the area identifier
58                   associated with the midpoint of the cell (IND1,IND2). The
59                   four possibilities are as described for the routine CPCICA.
60

USAGE

62       CPSCAE is not called by the user. When a user calls the routine CPCICA
63       and the internal parameter 'CAF' is negative, CPSCAE is called by
64       CPCICA exactly once for each cell in the cell array. The default
65       version of CPSCAE just sets the cell's color index equal to the area
66       identifier associated with the cell, if that area identifier is greater
67       than or equal to zero; otherwise, it does nothing.  A user-supplied
68       version of CPSCAE may do something more complicated; for example, it
69       may take into account both the value of the area identifier associated
70       with the cell and the current value of the color index for the cell in
71       determining the new value of the color index for the cell.
72

ACCESS

74       To use CPSCAE, load the NCAR Graphics libraries ncarg, ncarg_gks, and
75       ncarg_c, preferably in that order.
76

SEE ALSO

78       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
79       cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
80       cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb,
81       cprect, cprset, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
82

84       Copyright (C) 1987-2007
85       University Corporation for Atmospheric Research
86
87       This documentation is free software; you can redistribute it and/or
88       modify it under the terms of the GNU General Public License as
89       published by the Free Software Foundation; either version 2 of the
90       License, or (at your option) any later version.
91
92       This software is distributed in the hope that it will be useful, but
93       WITHOUT ANY WARRANTY; without even the implied warranty of
94       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
95       General Public License for more details.
96
97       You should have received a copy of the GNU General Public License along
98       with this software; if not, write to the Free Software Foundation,
99       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
100
101
102
103
104UNIX                              March 1993                    CPSCAE(3NCARG)
Impressum