PEXOCCSetViewIndex - Set View Index (5.0)

Synopsis 

 
   void PEXOCCSetViewIndex(
        PEXOCC context,
        unsigned int index
   )
 


 
   void PEXSetViewIndex(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        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 view table index.

Returns

None.

Description

Invoke PEXOCCSetViewIndex to create an attribute output command which sets the view index attribute in the renderer's pipeline state according to the value specified by index.

Use the view index to select an entry of the renderer's view table. The view defines a volume in world coordinates being viewed, from where it is viewed, and how it is placed in normalized projection coordinate (NPC) space.

If you specify an undefined view index, then the index defaults to view table index zero. If view index zero is not defined, then the implementation sets all clip flags to PEXClip, the clip limits to <0,0,0>, <1,1,1>; the orientation and mapping matrices to identity, and the eyepoint to PEXViewEyepointImplicit.

If the index you specify exceeds 65534, then the implementation issues a BadPEXOutputCommand error.

The view index function is a member of the global attribute set.

Errors

BadPEXOutputCommand
The view index value exceeds 65534.

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.