GLXSELECTEVENTSGIX(3GL)GLXSELECTEVENTSGIX(3GL)NAME
glXSelectEventSGIX - ask to receive GLX events on a drawable
C SPECIFICATION
void glXSelectEventSGIX ( Display *dpy,
GLXDrawable drawable,
unsigned long mask)
PARAMETERS
dpy Specifies the connection to the X server.
drawable Specifies the drawable whose event to receive.
mask Specifies the event mask for the drawable
DESCRIPTION
glXSelectEventSGIX asks the server to receive GLX event on a drwable
specified in mask. Only one GLX event, GLX_BUFFER_CLOBBER_MASK_SGIX,
can be selected.
The "buffer clobber" event is defined by:
Given Matrix P: P masked to preserve affine components:
typdef struct {
int event_type; /* GLX_DAMAGED_SGIX or GLX_SAVED_SGIX */
int draw_type; /* GLX_WINDOW_SGIX or GLX_PBUFFER_SGIX */
unsigned long serial; /* no. of last request processed by server */
Bool send_event; /* event was generated by a SendEvent request */
Display *display; /* display the event was read from */
GLXDrawable drawable; /* i.d. of Drawable */
unsigned int mask; /* mask indicating which buffers are affected*/
int x, y;
int width, height;
int count; /* if nonzero, at least this many more */
} GLXBufferClobberEventSGIX;
event_type Indicates the event type for a "buffer clobber" event. For
"preserved" pbuffers, an event, with GLX_SAVED_SGIX, is
generated whenever the contents of a pbuffer has to be
moved to avoid being damaged. For "unpreserved" pbuffers an
event, with GLX_DAMAGED_SGIX, is generated whenever a por‐
tion of the pbuffer becomes invalid. For Windows, "buffer
clobber" events, with GLX_DAMAGED_SGIX or GLX_SAVED_SGIX,
occur whenever an ancillary buffer, associated with the
window, gets clobbered or moved out of offscreen memory.
draw_type Indicates the drwable tye: GLX_WINDOW_SGIX or
GLX_PBUFFER_SGIXi.
mask Indicates which color or ancillary buffers were affected.
The following event is returned:
GLX_FRONT_LEFT_BUFFER_BIT_SGIX
GLX_FRONT_RIGHT_BUFFER_BIT_SGIX
GLX_BACK_LEFT_BUFFER_BIT_SGIX
GLX_BACK_RIGHT_BUFFER_BIT_SGIX
GLX_AUX_BUFFERS_BIT_SGIX
GLX_DEPTH_BUFFER_BIT_SGIX
GLX_STENCIL_BUFFER_BIT_SGIX
GLX_ACCUM_BUFFER_BIT_SGIX
GLX_SAMPLE_BUFFERS_BIT_SGIX
NOTES
1. In Sun's implementation, Pbuffer is allocated in the main memory
and always preserved. The ancillary buffers of a window and
pbuffer are also preserved, and never move out of the off-screen
memory. Thus, Sun's Xserver does not generate "buffer clobber"
event.
2. glXSelectEventSGIX is part of the GLX extension SGIX_pbuffer,
not part of the core GLX command set. If SGIX_pbuffer is
included in the string returned by glXQueryExtensionsString,
extension SGIX_pbuffer is supported by the connection.
3. This function is superseded by glXSelectEvent, which is part of
GLX Version 1.3 command set. glXSelectEventSGIX is supported
only for backward comaptibility.
ERRORS
GLXBadDrawable is generated if drawable is not a valid GLXPbuffer or a
valid window.
SEE ALSO
glXCreateGLXPbufferSGIX, glXGetSelectedEventSGIX, glXQueryExtension‐
sString.
21 May 01 GLXSELECTEVENTSGIX(3GL)