NAME

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

SYNOPSIS

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

DESCRIPTION

       The first eight arguments of CPSCAE describe the user's cell array and are taken directly from the user's
       call to CPCICA:

       ICRA        (INTEGER  array,  dimensioned ICA1 by "n", where "n" is greater than or equal to the value of
                   the argument ICAN, input/output) is the user's cell array. Generally speaking, a user version
                   of CPSCAE should only reset the value of the single element ICRA(IND1,IND2).

       ICA1        (INTEGER, input) is the first dimension of the FORTRAN array ICRA, which contains the  user's
                   cell array.

       ICAM        (INTEGER, input) is the first dimension of the user's cell array.

       ICAN        (INTEGER, input) is the second dimension of the user's cell array.

       XCPF and YCPF
                   (REAL,  input)  are  the coordinates, in the fractional coordinate system, of a point P. P is
                   the point at that corner of the  rectangular  area  into  which  the  cell  array  maps  that
                   corresponds to the cell (1,1).

       XCQF and YCQF
                   (REAL,  input)  are  the coordinates, in the fractional coordinate system, of a point Q. Q is
                   the point at that corner of the  rectangular  area  into  which  the  cell  array  maps  that
                   corresponds to the cell (ICAM,ICAN).

       IND1 and IND2
                   (INTEGER, input) are the indices of an element in the cell array that is to be reset.

       ICAF        (INTEGER,  input)  is  the  value  of  the internal parameter 'CAF', which will be a negative
                   integer (because, when 'CAF' is greater than or equal to zero,  the  routine  CPSCAE  is  not
                   called).  Different  values  of  'CAF'  may  be  used  in  a user version of CPSCAE to select
                   different schemes for picking color indices.

       IAID        (INTEGER, input) is the value of the area identifier associated with the midpoint of the cell
                   (IND1,IND2). The four possibilities are as described for the routine CPCICA.

USAGE

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

ACCESS

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

SEE ALSO

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

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     CPSCAE(3NCARG)