NAME

       GCA - Draw a cell array

DESCRIPTION

       GCA  (Cell  array)  - draws a cell array starting with a rectangle specified by two corner
       points; this initial rectangle is subdivided into subrectangles by specifying an arbitrary
       number  of  divisions in the X and Y directions; each subrectangle (or cell) is assigned a
       color and drawn with that color.

SYNOPSIS

       CALL GCA (XP1, YP1, XP2, YP2, NXCLR, NYCLR, IXCLR, IYCLR, NXDO, NYDO, CLRIA)

C-BINDING SYNOPSIS

       #include <ncarg/gks.h>

       void gcell_array(const Grect *rect, const Gpat_rep *colr_array);

DESCRIPTION

       XP1         (Real, Input) - X world coordinate of point 1.

       YP1         (Real, Input) - Y world coordinate of point 1.

       XP2         (Real, Input) - X world coordinate of point 2.

       YP2         (Real, Input) - Y world coordinate of point 2.

       NXCLR       (Integer, Input) - X dimension of the color index array CLRIA.

       NYCLR       (Integer, Input) - Y dimension of the color index array CLRIA.

       IXCLR       (Integer, Input) - The index of the starting column in index array CLRIA.

       IYCLR       (Integer, Input) - The index of the starting row in index array CLRIA.

       NXDO        (Integer, Input) - Number of cell elements to draw in the X dimension.

       NYDO        (Integer, Input) - Number of cell elements to draw in the Y dimension.

       CLRIA       (Integer array, Input) - An array of color indices dimensioned NXCLR  x  NYCLR
                   which is used to determine the color of each cell drawn.

USAGE

       Points 1 and 2 must be diagonally opposite corner points of a rectangle to be divided into
       NXDO cells in the X dimension and NYDO cells in the Y dimension.

ACCESS

       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.

SEE ALSO

       Online: gscr, gcell_array

       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

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