glxqueryglxpbuffersgix(3G)



glXQueryGLXPbufferSGIX(3G)  OpenGL Reference - GLX  glXQueryGLXPbufferSGIX(3G)



NAME
     glXQueryGLXPbufferSGIX - returns information about a GLX pixel buffer


C SPECIFICATION
     int glXQueryGLXPbufferSGIX( Display *dpy,
                                 GLXPbufferSGIX pbuf,
                                 int attribute,
                                 unsigned int *value )


PARAMETERS
     dpy        Specifies the connection to the X server.

     pbuf       Specifies the GLX pixel buffer to be queried.

     attribute  Specifies the attribute to be returned.

     value      Returns the requested value.


DESCRIPTION
     glXQueryGLXPbufferSGIX sets value to the attribute value for pbuf.  It
     returns an error code if it fails for any reason.  Otherwise, zero is
     returned.

     attribute is one of the following:

     GLXWIDTHSGIX        Width of pbuf.

     GLXHEIGHTSGIX       Height of pbuf.

     GLXPRESERVEDCONTENTSSGIX
                           True if the contents of pbuf are preserved when a
                           resource conflict occurs; False otherwise.

     GLXLARGESTPBUFFERSGIX
                           Set when the GLX pixel buffer is created by calling
                           glXCreateGLXPbufferSGIX.  When False,
                           glXCreateGLXPbufferSGIX fails if it cannot allocate
                           a GLX pixel buffer of size width by height.  When
                           True, a pixel buffer with the largest width and
                           height possible (but not larger than the values
                           specified) is created when the allocation of the
                           buffer would otherwise fail.

     GLXDIGITALMEDIAPBUFFERSGIX
                           True if pbuf can be associated with a compatible
                           DMbuffer; False otherwise.






                                                                        Page 1



glXQueryGLXPbufferSGIX(3G)  OpenGL Reference - GLX  glXQueryGLXPbufferSGIX(3G)



     GLXFBCONFIGIDSGIX  XID for pbuf.

NOTES
     glXQueryGLXPbufferSGIX is part of the SGIXpbuffer extension.


ERRORS
     A GLXBadPbufferSGIX is generated if pbuf is not a valid GLX pixel buffer.

     GLXBADATTRIB is returned if attribute is not a valid GLX attribute.



MACHINE DEPENDENCIES
     The SGIXpbuffer extension is supported only on RealityEngine,
     RealityEngine2, and VTX systems, on InfiniteReality systems, on High
     Impact and Maximum Impact systems, and on O2 systems.

     The SGIXdmpbuffer extension is currently supported only on O2 systems.

     On O2 systems the GLXLARGESTPBUFFERSGIX attribute may incorrectly
     limit the size of the pbuffer created when the requested dimensions are
     larger than the screen.  It is possible to allocate pbuffers up to 2048
     square with the attribute set to False.


SEE ALSO
     glXCreateGLXPbufferSGIX, glXGetFBConfigAttribSGIX, glXChooseFBConfigSGIX



























                                                                        Page 2

Museum