PEXOCCCellArray2D - 2D Cell Array Primitive (5.0)


Synopsis

 
   void PEXOCCCellArray2D(
        PEXOCC context,
        PEXCoord2D *point1,
        PEXCoord2D *point2,
        unsigned int col_count,
        unsigned int row_count,
        PEXTableIndex *color_indices
     )
 

 
     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

context
An OC context returned by a successful PEXCreateOCC call.

display (OCC)
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

point1
The first cell array definition point.

point2
The second cell array definition point.

col_count
The number of cell columns (number of cells in the x direction).

row_count
The number of cell rows (number of cells in the y direction).

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

Returns

None.

Description

Invoke PEXOCCCellArray2D to create a two-dimensional cell array primitive output command (PEXOCCellArray2D).

A 2D cell-array is a rectangle of equally-sized cells, each of which is a rectangle which has a single color. Specify this primitive as 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 the PEXCellArray primitive.

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

For primitives similar to this one, see:

For PEXlib 5.1 compatibility primitives similar to this one see:

For attributes that affect this primitive, see Surfaces - General Attributes.

For an overview, see Output Command Functions.