NAME

       CPCICA - Incorporates into a user's cell array color indices determined by examining where the user's
       contours lie relative to the cell array.

SYNOPSIS

        CALL CPCICA (ZDAT, RWRK, IWRK, ICRA, ICA1, ICAM, ICAN,
       + XCPF, YCPF, XCQF, YCQF)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_cpcica (float *zdat, float *rwrk, int *iwrk,
       int *icra, int ica1, int icam, int ican, float xcpf,
       float ycpf, float xcqf, float ycqf)

DESCRIPTION

       The first three arguments are arrays used in the last call to CPRECT, CPSPS1, or CPSPS2, the contents of
       which must not have been changed since that call.

       ZDAT        (REAL  array,  dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input)
                   is the data array.

       RWRK        (REAL array, dimensioned as specified  in  the  last  call  to  CPRECT,  CPSPS1,  or  CPSPS2,
                   input/output) is the real workspace array.

       IWRK        (INTEGER  array,  dimensioned  as  specified  in  the last call to CPRECT, CPSPS1, or CPSPS2,
                   input/output) is the integer workspace array.

       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.

       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).

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions, with the following
       exceptions:

       icra        icra is dimensioned n by ica1 where n is greater than or equal to the value of  the  argument
                   ican

       ica1        The second dimension of the array icra.

EXAMPLES

       Use the ncargex command to see the following relevant examples: ccpcica, ccpmovi.

ACCESS

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

MESSAGES

       See the conpack man page for a description of all Conpack error messages and/or informational messages.

SEE ALSO

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

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     CPCICA(3NCARG)