PEXDBAllocateBackBufferName - Allocate a Name for a Window's Back Buffer


Synopsis

 
   Drawable PEXDBAllocateBackBufferName(
            Display *display,
            Window window,
            int hint
   )
 

Arguments

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

window
The ID of the window for which to allocate the back buffer name.

hint
One of PEXDBSwapUndefined, PEXDBSwapBackground, PEXDBSwapUntouched, PEXDBSwapCopied. See PEXDBSwapBuffer for a description of the swap actions.

Returns

A Drawable ID that references the back buffer for the specified window.

Description

Invoke PEXDBAllocateBackBufferName to request an ID for the back buffer associated with the specified window.

If the specified window does not have a back buffer already associated with it, the implementation allocates the back buffer and returns a name associated with it. If the window already has a back buffer, the implementation does not allocate a new back buffer, but instead returns a unique ID that references the same back buffer already associated with the specified window. It is impossible for the client to allocate more than one back buffer for a given window.

Supply one of the values for hint to indicate the swap action that you are most likely to use for subsequent swap requests.

Errors

BadAlloc
The implementation failed to allocate memory to satisfy request.

BadMatch
The specified window is not capable of double buffering.

BadValue
The specified hint is invalid.

BadWindow
The specified window is invalid.

See Also

For an overview, see PEXlib Access and Information Functions.