PEXSetWorkstationDisplayUpdateMode - Set Workstation Display Update Mode

Synopsis 

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

Arguments

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

workstation
The resource identifier of the workstation.

update_mode
The workstation display update mode (PEXVisualizeEach, PEXVisualizeEasy, PEXVisualizeNone, PEXSimulateSome or PEXVisualizeWhenever).

Returns

None.

Description

Invoke PEXSetWorkstationDisplayUpdateMode to set the display update attribute of the specified workstation.

The display update attribute defines how changes to the display surface are visualized. To inquire the supported values for display update mode, invoke the PEXGetEnumTypeInfo function.

If double-buffering is enabled, then the display update mode affects which buffer is rendered into during traversal. If the display update mode is PEXVisualizeEach, PEXVisualizeWhenever or PEXVisualizeNone, then 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, then output primitives are always rendered into the front (displayed) buffer.

Errors

BadPEXWorkstation
The specified workstation resource identifier is invalid.

BadValue
The specified display update mode is invalid.

See Also

For a list of PHIGS Workstation functions and related topics, see PHIGS Workstation.