Name

PEXUtDBClear − clear the window back buffer

Syntax

int PEXUtDBClear(Display *dpy, Window win)

Parameters

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

winThe resource identifier of the window for which the back buffer is cleared. 

Returns

The function returns a value of zero if it is successful; otherwise, a non-zero value is returned. 

Description

The function will clear the back buffer associated with the specified window. If the window is not configured for double-buffering, the function will clear the window. 

On PEX 5.1 servers, the best way to clear the back buffer is to clear during or with the drawable identifier of the back buffer. (This is done by setting the renderer’s clear_image flag to

On PEX 5.0 servers, the back buffer can also be cleared by setting the clear argument in to

Restrictions

If it is necessary to ensure that all actions have completed before proceeding, the application should call after calling

This function should not be called with a window into which PEX is rendering.  should be called prior to

Renderer clip lists do not affect the clear operation. The entire back buffer is cleared. 

See Also

(c) Hewlett-Packard Company  —  HP PEXlib Release 5.1: January 1993