PEXOCCSetParaSurfBundleIndex - Set Parametric Surface Bundle Index (5.2)


Synopsis

 
   void PEXOCCSetParaSurfBundleIndex(
        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 parametric surface bundle table index.

Returns

None.

Description

Invoke PEXOCCSetParaSurfBundleIndex to set the parametric surface bundle index entry of the renderer's pipeline state according to the value specified by index.

You use the parametric surface bundle index to select an entry of the renderer's interior bundle table whenever a bundlable parametric surface attribute's ASF is set to PEXBundled (see PEXOCCSetIndividualASF) and the renderer's PHIGS interior bundle mode is True. If you set the PHIGS interior bundle mode to False, then the implementation uses the interior bundle index instead and ignores the parametric surface bundle index. PEXlib supports the bundling of the following parametric surface attributes: surface approximation and parametric surface characteristics.

If you specify an undefined index, then the index defaults to index one. If index one is not defined, then the implementation sets the bundled surface approximation to PEXApproxImpDep and the parametric surface characteristics to PEXPSCNone. If you specify a parametric surface bundle table index of zero, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the curved surface and parametric surface attribute sets.

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 an overview and for a list of all output attribute functions, see Output Attribute Functions.