PEXExecuteStructure(3) — Subroutines

Name

PEXExecuteStructure - Execute Structure

Synopsis

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

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call.

resource_idThe resource identifier of the renderer or structure.

req_typeThe request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

structureThe resource identifier of the structure.

Returns

None

Description

This function creates an execute structure output command which causes the specified structure to be executed during structure traversal. Executing a structure consists of these steps:

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

If structure does not exist at the time PEXExecuteStructure is processed, a BadPEXOutputCommand error is produced. The structure must first be created.

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.

Museum