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:

     GLX_WIDTH_SGIX        Width of pbuf.

     GLX_HEIGHT_SGIX       Height of pbuf.

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

     GLX_LARGEST_PBUFFER_SGIX
                           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.

     GLX_DIGITAL_MEDIA_PBUFFER_SGIX
                           True if pbuf can be associated with a compatible
                           DMbuffer; False otherwise.
     GLX_FBCONFIG_ID_SGIX  XID for pbuf.

NOTES
     glXQueryGLXPbufferSGIX is part of the SGIX_pbuffer extension.


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

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



MACHINE DEPENDENCIES
     The SGIX_pbuffer 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 SGIX_dm_pbuffer extension is currently supported only on O2 systems.

     On O2 systems the GLX_LARGEST_PBUFFER_SGIX 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