Name

PEXSetWorkstationDisplayUpdateMode - Set Workstation Display Update Mode

Synopsis

void PEXSetWorkstationDisplayUpdateMode(Display ∗display, PEXWorkstation workstation, int update_mode)

Arguments

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

workstationThe resource identifier of the workstation. 

update_modeThe workstation display update mode (PEXVisualizeEach, PEXVisualizeEasy, PEXVisualizeNone, PEXSimulateSome, PEXVisualizeWhenever).

Returns

None

Description

This function sets the display update attribute of the specified workstation.  This attribute defines how changes to the display surface will be visualized.  The supported values for display update mode are inquirable via PEXGetEnumTypeInfo.

If double-buffering is enabled, the display update mode affects which buffer is rendered into during traversal.  If the display update mode is PEXVisualizeEach, PEXVisualizeWhenever or PEXVisualizeNone, output primitives are rendered into the back (undisplayed) buffer while the structure network is being traversed. When the traversal is complete, the front and back buffers are swapped, so the rendered image is displayed.  If the display update mode is PEXVisualizeEasy or PEXSimulateSome, output primitives are always rendered into the front (displayed) buffer.

Data Structures

typedef XID             PEXWorkstation;

Errors

BadPEXWorkstation
The specified workstation resource identifier is invalid.

BadValueThe specified display update mode is invalid. 

See Also

PEXSetWorkstationBufferMode, PEXGetEnumTypeInfo