.\" @(#)PEXCellArray.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCellArray 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCellArray \- 3D Cell Array Primitive
.SH SYNTAX
.HP
void PEXCellArray\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, PEXCoord *\fIpoint1\fP\^, PEXCoord *\fIpoint2\fP\^,
PEXCoord *\fIpoint3\fP\^, unsigned int \fIcol_count\fP\^, unsigned int \fIrow_count\fP\^, PEXTableIndex *\fIcolor_indices\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIresource_id\fP
The resource identifier of the renderer or structure.
.TP
\fIreq_type\fP
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.TP
\fIpoint1\fP
The first cell array definition point.
.TP
\fIpoint2\fP
The second cell array definition point.
.TP
\fIpoint3\fP
The third cell array definition point.
.TP
\fIcol_count\fP
The number of cell columns (number of cells in the \s-1X\s0 direction).
.TP
\fIrow_count\fP
The number of cell rows (number of cells in the \s-1Y\s0 direction).
.TP
\fIcolor_indices\fP
An array of color table index values which specify the color of each cell.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXCellArray
.IX "Cell Array" PEXCellArray
.LP
This function creates a 3D cell-array output primitive.
.LP
A 3D cell-array primitive is a parallelogram of equally-sized
cells, each of which is a parallelogram with a single color.
Each cell has a width defined by:
.\"@
.\" start equation_nroff_version
.if t .ig xx
.bp
.nf
           /-----------------------------------
          / (point1->x - point2->x)sqrt 2 +
         /  (point1->y - point2->y)sqrt 2 +
        V   (point1->z - point2->z)sqrt 2 +
width =    ------------------------------------
                        col_count
.sp
and a height defined by:
.sp
           /-----------------------------------
          / (point1->x - point3->x)sqrt 2 +
         /  (point1->y - point3->y)sqrt 2 +
        V   (point1->z - point3->z)sqrt 2 +
width =    ------------------------------------
                        row_count
.fi
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.sp
.LP
.EQ
\s-1width ~=~\s0 sqrt {(\s-1point1->x ~-~ point2->x) sup 2 ~+~ (point1->y ~-~ point2->y) sup 2 ~+~ (point1->z ~-~ point2->z) sup 2\s0} over \s-1col_count\s0
.EN
.LP
and a height defined by:
.sp .5
.LP
.EQ
\s-1height ~=~\s0 sqrt {(\s-1point1->x ~-~ point3->x) sup 2 ~+~ (point1->y ~-~ point3->y) sup 2 ~+~ (point1->z ~-~ point3->z) sup 2\s0} over \s-1row_count\s0
.EN
.sp
.yy
.LP
Cell colors are specified in a one-dimensional array where the colors are
stored in row-major order.
The first color in the array is the color at the cell at the
corner of point1, and subsequent colors represent the colors
of cells proceeding to
.I point2.
.LP
If any color index is not defined, color index one is used.  If color index
one is not defined, the resulting color is implementation-dependent.
The column count and row count can not be zero.
.SH DATA STRUCTURES
.LP
.nf
typedef  unsigned short		PEXTableIndex;
.fi
.sp .5
See also
.B PEXlib.h.
.SH ERRORS
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.