PEXOCCSetBFReflectanceBundleIndex - Set Back-Facing Reflectance Bundle Index (5.2)


Synopsis

 
     void PEXOCCSetBFReflectanceBundleIndex(
          PEXOCC context,
          unsigned int index
     )
 

Arguments

context
An OC context returned by a successful PEXCreateOCCcall.

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 interior bundle table.

Returns

None.

Description

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

You use the back-facing reflectance bundle index to select an entry of the renderer's interior bundle table whenever a bundlable back-facing reflectance attribute's ASF is set to PEXBundled (see PEXOCCSetIndividualASF) and you have set the renderer's PHIGS interior bundle table to True. If you set the PHIGS interior bundle mode to False, then the implementation uses the back-facing interior bundle index instead and ignores the back-facing reflectance bundle index.

To apply the back-facing attributes to the back-facing interiors of output primitives, you must set the facet distinguish flag to True (see PEXOCCSetFacetDistinguishFlag). If you set the flag to False, then the implementation uses the interior bundle index (see PEXOCCSetReflectanceBundleIndex) and ignores the back-facing interior bundle index.

If you specify a back-facing reflectance bundle index of zero, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the general surface attribute set.

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 output attribute functions, see Output Attribute Functions.