Name

PEXCellArray2D - 2D Cell Array Primitive

Synopsis

void PEXCellArray2D(Display ∗display, XID resource_id, PEXOCRequestType req_type, PEXCoord2D ∗point1, PEXCoord2D ∗point2, unsigned int col_count, unsigned int row_count, PEXTableIndex ∗color_indices)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call. 

resource_idThe resource identifier of the renderer or structure. 

req_typeThe request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

point1The first cell array definition point. 

point2The second cell array definition point. 

col_countThe number of cell columns (number of cells in the X direction). 

row_countThe number of cell rows (number of cells in the Y direction). 

color_indicesAn array of color table index values which specify the color of each cell. 

Returns

None

Description

This function creates a 2D cell array output primitive. 

A 2D cell-array is a rectangle of equally-sized cells, each of which is a rectangle which has a single color.  The primitive is specified by two points which define a rectangle aligned with the modeling coordinate axes.  The width and height of each cell is defined as in PEXCellArray where the z component is zero.

All other aspects of this primitive are the same as PEXCellArray.

Data Structures

typedef unsigned short  PEXTableIndex;
See also the PEXStructuresman page.

Errors

BadPEXOutputCommand
The output command contains an invalid value.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also