PEXOCCSetBFInteriorBundleIndex - Set Back-Facing Interior Bundle Index (5.2)


Synopsis

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

Returns

None.

Description

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

You use the back-facing interior bundle index to select an entry of the renderer's interior bundle table whenever a bundlable back-facing interior attribute's ASF is set to PEXBundled (see PEXOCCSetIndividualASF) and you have set the renderer's PHIGS interior bundle table to True. PEXlib supports the bundling of the following back-facing interior attributes: back-facing surface interior style, back-facing surface interior style index, back-facing surface color, and back-facing surface interpolation method.

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 PEXOCCSetInteriorBundleIndex) and ignores the back-facing interior bundle index.

If you specify an undefined interior bundle index, then the index defaults to index one. If index one is not defined, then the implementation sets the bundled back-facing surface interior style to PEXInteriorStyleHollow, back-facing interior style index to 1, back-facing surface color to index color 1, and back-facing surface interpolation method to PEXSurfaceInterpNone. If you specify an interior bundle index of zero, then the implementation issues a BadPEXOutputCommand error.

See also the discussion on PHIGS interior bundle mode.

This function is a member of the styled and shaded 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 all output attribute functions, see Output Attribute Functions.