PEXSetWorkstationBufferMode - Set Workstation Buffer Mode

Synopsis 

 
   void PEXSetWorkstationBufferMode(
        Display *display,
        PEXWorkstation workstation,
        int buffer_mode
    )

Arguments

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

workstation
The resource identifier of the workstation.

buffer_mode
The workstation buffering mode (PEXSingleBuffer or PEXDoubleBuffer).

Returns

None.

Description

Invoke PEXSetWorkstationBufferMode to set the requested buffer mode of the specified workstation.

If the workstation's display surface attribute is PEXEmpty, or if the dynamic modification for buffer mode is PEXIMM, then this function sets the current buffer mode to the specified buffer mode and sets the buffer update to PEXNotPending. Otherwise, the buffer update is set to PEXPending and the current buffer mode is not changed.

PEXlib defines the following buffer modes: PEXSingleBuffer or PEXDoubleBuffer. If the buffer mode is PEXDoubleBuffer and the implementation cannot allocate the second image buffer, then the implementation issues a BadAlloc error.

Errors

BadAlloc
The implementation failed to allocate resources needed for double-buffering.

BadPEXWorkstation
The specified workstation resource identifier is invalid.

BadValue
The specified buffer mode is invalid.

See Also

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