PEXOCCCellArray - 3D Cell Array Primitive (5.0)

Synopsis 

   void PEXOCCCellArray(
        PEXOCC context,
        PEXCoord *point1,
        PEXCoord *point2,
        PEXCoord *point3,
        unsigned int col_count,
        unsigned int row_count,
        PEXTableIndex *color_indices
     )


   void PEXCellArray(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        PEXCoord *point1,
        PEXCoord *point2,
        PEXCoord *point3,
        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.

point3
The third 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 PEXOCCCellArray to create a three-dimensional cell-array primitive output command (PEXOCCellArray).

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:

and a height defined by:

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 point2.

PEXlib does not support a value of zero for the column count and row count (col_count and row_count arguments respectively).

If your application does not define a color index, then the color index defaults to a value of one. If the implementation does not define color index one, then the result is implementation-dependent.

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.