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:
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.
Page 1
glXQueryGLXPbufferSGIX(3G) OpenGL Reference - GLX glXQueryGLXPbufferSGIX(3G)
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
Page 2
