.\" @(#)PEXExtendedCellArray.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXExtendedCellArray 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXExtendedCellArray - Extended 3D Cell Array Primitive
.SH SYNTAX
.HP
void PEXExtendedCellArray\^(\^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\^, int \fIcolor_type\fP\^, PEXArrayOfColor \fIcolors\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIpoint1\fP 1i
The first cell array definition point.
.IP \fIpoint2\fP 1i
The second cell array definition point.
.IP \fIpoint3\fP 1i
The third cell array definition point.
.IP \fIcol_count\fP 1i
The number of cell columns (number of cells in the \s-1X\s0 direction).
.IP \fIrow_count\fP 1i
The number of cell rows (number of cells in the \s-1Y\s0 direction).
.IP \fIcolor_type\fP 1i
The type of color for the cell colors (
.B PEXColorTypeIndexed,
.B PEXColorTypeRGB,
.B PEXColorTypeCIE,
.B PEXColorTypeHSV,
.B PEXColorTypeHLS,
.B PEXColorTypeRGB8,
.B PEXColorTypeRGB16
).
.IP \fIcolors\fP 1i
An array of colors specifying the color of each cell.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXExtendedCellArray
.IX "Cell Array" PEXExtendedCellArray
.LP
This function creates a \s-13D\s0 cell array output primitive.
.LP
This function is similar to
.BR PEXCellArray (3) ,
except the colors are passed as either
indexed color values or direct color values, depending on the color type.
.SH DATA STRUCTURES
.LP
.nf
typedef union {
	PEXColorIndexed	*indexed;
	PEXColorRGB		*rgb;
	PEXColorHSV		*hsv;
	PEXColorHLS		*hls;
	PEXColorCIE		*cie;
	PEXColorRGB8		*rgb8;
	PEXColorRGB16	*rgb16;
.br
} PEXArrayOfColor;
.fi
.sp .5
See also
.B PEXlib.h.
.SH ERRORS
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.bp
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.