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-2009
85       University Corporation for Atmospheric Research
86
87       The use of this Software is governed by a License Agreement.
88
89
90
91UNIX                              March 1993                    CPSCAE(3NCARG)
Impressum