ncl_cpscae man page

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

Info

March 1993 UNIX NCAR GRAPHICS