PEXOCCSetBFDataMappingIndex - Set Back-Facing Data Mapping Index (5.2)

Synopsis 

 
   void PEXOCCSetBFDataMappingIndex(
           PEXOCC context,
           unsigned int index
      )

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

index
The index into the data mapping table.

Returns

None.

Description

Invoke PEXOCCSetBFDataMappingIndex to create an attribute output command which sets the back- facing data mapping index attribute in the renderer's pipeline state according to the value specified by index.

You use the data mapping index to select an entry of the renderer's data mapping table. This entry supplies the data mapping method when you set the data mapping method attribute's ASF to PEXBundled (see PEXOCCSetIndividualASF).

To apply the back-facing data mapping index to the back-facing surfaces of output primitives which can be data mapped, you must set the facet distinguish flag to True (see PEXOCCSetFacetDistinguishFlag). If you set the flag to False, then the implementation uses the data mapping index when rendering back-facing surfaces (see PEXOCCSetDataMappingMethod).

If you specify an index of zero, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the data mapping attribute set and affects all output primitives which can be data mapped.

Errors

BadPEXOutputCommand
The index is zero.
BadPEXRenderer
The specified renderer resource identifier is invalid.
BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview and for a list of all output attribute functions, see Output Attribute Functions.