PEXOCCExecuteStructure - Execute Structure (5.0)

Synopsis

 
   void PEXOCCExecuteStructure(
        PEXOCC context,
        PEXStructure structure
   )

 
   void PEXExecuteStructure(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        PEXStructure structure
   )

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).
structure: The resource identifier of the structure.

Returns

None.

Description

Invoke PEXOCCExecuteStructure to create an execute structure output command which causes the specified structure to be executed during structure traversal.

Executing a structure consists of these steps:

Save the current state of the rendering pipeline.
Set the global transform to the current composite modeling transform.
Set the local transform to the identity matrix.
Process all structure elements in the called structure.
Restore the state saved at step 1.

If structure does not exist at the time PEXOCCExecuteStructure is processed, then the implementation issues a BadPEXOutputCommand error. You must first create the structure.

Errors