PEXOCCExtendedCellArray - Extended 3D Cell Array Primitive (5.0)


Synopsis

 
     void PEXOCCExtendedCellArray(
          PEXOCC context,
          PEXCoord *point1,
          PEXCoord *point2,
          PEXCoord *point3,
          unsigned int col_count,
          unsigned int row_count,
          PEXPointer colors
      )
 

 
     void PEXExtendedCellArray(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          PEXCoord *point1,
          PEXCoord *point2,
          PEXCoord *point3,
          unsigned int col_count,
          unsigned int row_count,
          int color_type,
          PEXArrayOfColor colors
     )
 

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_type (OCC)
The type of color for the cell colors (PEXColorTypeIndexed, PEXColorTypeRGB, PEXColorTypeCIE, PEXColorTypeHSV, PEXColorTypeHLS, PEXColorTypeRGB8, PEXColorTypeRGB16, PEXColorTypeRGBA, PEXColorTypeRGBA8, or PEXColorTypeRGBA16).

colors
An array of colors specifying the color of each cell. The OCC form of this function allows you to point directly at a list of colors instead of using the PEXArrayOfColor union.

Returns

None.

Description

Invoke PEXOCCExtendedCellArray to create a three-dimensional cell array primitive output command (PEXOCExtendedCellArray).

This primitive is similar to the PEXCellArray primitive, except depending on the color_type you specify, this primitive passes the colors as either indexed color or direct color values.

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.