# Cell Array Output

Discussed here is the cell array output primitive GCA. Cell array has no attributes.

## Cell Array Primitive

The cell array output primitive starts with a rectangle specified by two diagonally opposite 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.
```----------------------------------------------------
Argument | Type    |  Mode | Dimension
----------------------------------------------------
CALL GCA  (XP1,    | Real    | Input |
YP1,    | Real    | Input |
XP2,    | Real    | Input |
YP2,    | Real    | Input |
NXCLR,  | Integer | Input |
NYCLR,  | Integer | Input |
IXCLR,  | Integer | Input |
IYCLR,  | Integer | Input |
NXDO,   | Integer | Input |
NYDO,   | Integer | Input |
CLRIA)  | Integer | Input | NXCLR x NYCLR
-----------------------------------------------------
```
XP1
X world coordinate of point 1 (see below).
YP1
Y world coordinate of point 1 (see below).
XP2
X world coordinate of point 2 (see below).
YP2
Y world coordinate of point 2 (see below).
NXCLR
X dimension of the color index array CLRIA.
NYCLR
Y dimension of the color index array CLRIA.
IXCLR
The index of the starting column in index array CLRIA.
IYCLR
The index of the starting row in index array CLRIA.
NXDO
Number of cell elements to draw in the X dimension.
NYDO
Number of cell elements to draw in the Y dimension.
CLRIA
An array of color indices dimensioned NXCLR x NYCLR which is used to determine the color of each cell drawn.
Defaults:
none
Errors:
5, 84
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.
```------------------------------------------------------------------------
C Synopsis

#include <ncarg/gks.h>

void gcell_array(
const Grect     *rect,       /*  cell rectangle  */
const Gpat_rep  *colr_array  /*  color array     */
);
------------------------------------------------------------------------
```