Name

PEXBeginStructure - Save Rendering Pipeline State

Synopsis

void PEXBeginStructure(Display ∗display, PEXRenderer renderer, long structure_id)

Arguments

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

rendererThe resource identifier of a renderer. 

structure_idA value to be used as an application-specified structure identifier. 

Returns

None

Description

Application programs can use this function to simulate the effects of the execute structure output command.  This request saves the rendering pipeline attributes in the specified renderer.  This request also increments the element offset of the last entry in the renderer’s current path.  The function then adds the structure id and an element offset of zero to the renderer’s current path. 

The rendering pipeline’s global transform attribute is set to the matrix computed by concatenating the current local transform and current global transform matrices.  The local transform matrix is then set to the identity matrix. 

Data Structures

typedef XID             PEXRenderer;

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

See Also

PEXEndStructure, PEXExecuteStructure, PEXCreateRenderer