[ новости /+++ | форум | теги | ]

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  con-
                 tents  of  a  pbuffer  has  to be moved to avoid
                 being damaged.  For  "unpreserved"  pbuffers  an
                 event, with GLX_DAMAGED_SGIX, is generated when-
                 ever a portion of the pbuffer  becomes  invalid.
                 For   Windows,  "buffer  clobber"  events,  with
                 GLX_DAMAGED_SGIX or GLX_SAVED_SGIX, occur  when-
                 ever  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.

ERRORS
     GLXBadDrawable is generated  if  drawable  is  not  a  valid
     GLXPbuffer or a valid window.

SEE ALSO
     glXCreateGLXPbufferSGIX,            glXGetSelectedEventSGIX,
     glXQueryExtensionsString.

Партнёры:

Хостинг: