glXGetFBConfigAttribSGIX(3G) OpenGL Reference - GLX
NAME
glXGetFBConfigAttribSGIX - return information about a GLX frame buffer
configuraton
C SPECIFICATION
int glXGetFBConfigAttribSGIX( Display *dpy,
GLXFBConfigSGIX config,
int attribute,
int *value )
PARAMETERS
dpy Specifies the connection to the X server.
config Specifies the GLX frame buffer configuration to be queried.
attribute Specifies the attribute to be returned.
value Returns the requested value.
DESCRIPTION
glXGetFBConfigAttribSGIX sets value to the attribute value of GLX
drawables created with respect to config. glXGetFBConfigAttribSGIX
returns an error code if it fails for any reason. Otherwise, zero is
returned.
attribute is one of the following:
GLXBUFFERSIZE Number of bits per color buffer. If the frame
buffer configuration supports RGBA contexts then
GLXBUFFERSIZE is the sum of GLXREDSIZE,
GLXGREENSIZE, GLXBLUESIZE, and GLXALPHASIZE.
If the frame buffer configuration supports only
color index contexts, GLXBUFFERSIZE is the size
of the color indexes.
GLXLEVEL Frame buffer level of the configuration. Level
zero is the default frame buffer. Positive levels
correspond to frame buffers that overlay the
default buffer, and negative levels correspond to
frame buffers that underlay the default buffer.
GLXDOUBLEBUFFER True if color buffers exist in front/back pairs
that can be swapped, False otherwise.
Page 1
glXGetFBConfigAttribSGIX(3G) OpenGL Reference - GLX
GLXSTEREO True if color buffers exist in left/right pairs,
False otherwise.
GLXAUXBUFFERS Number of auxiliary color buffers that are
available. Zero indicates that no auxiliary color
buffers exist.
GLXREDSIZE Number of bits of red stored in each color buffer.
Undefined if RGBA contexts are not supported by the
frame buffer configuration.
GLXGREENSIZE Number of bits of green stored in each color
buffer. Undefined if RGBA contexts are not
supported by the frame buffer configuration.
GLXBLUESIZE Number of bits of blue stored in each color buffer.
Undefined if RGBA contexts are not supported by the
frame buffer configuration.
GLXALPHASIZE Number of bits of alpha stored in each color
buffer. Undefined if RGBA contexts are not
supported by the frame buffer configuration.
GLXDEPTHSIZE Number of bits in the depth buffer.
GLXSTENCILSIZE Number of bits in the stencil buffer.
GLXACCUMREDSIZE Number of bits of red stored in the accumulation
buffer.
GLXACCUMGREENSIZE Number of bits of green stored in the accumulation
buffer.
GLXACCUMBLUESIZE Number of bits of blue stored in the accumulation
buffer.
GLXACCUMALPHASIZE Number of bits of alpha stored in the accumulation
buffer.
GLXSAMPLEBUFFERSSGIS
Number of multisample buffers.
GLXSAMPLESSGIS Number of samples per pixel in multisample buffers.
GLXXVISUALTYPEEXT Visual type of associated visual. Undefined if
there is no associated visual (i.e., if
GLXXRENDERABLESGIX is False or
GLXDRAWABLETYPESGIX does not have the
GLXWINDOWBITSGIX bit set.)
Page 2
glXGetFBConfigAttribSGIX(3G) OpenGL Reference - GLX
GLXTRANSPARENTTYPEEXT
One of GLXNONEEXT, GLXTRANSPARENTRGBEXT,
GLXTRANSPARENTINDEXEXT, indicating that the
frame buffer configuration is opaque, is
transparent for particular values of red, green and
blue or is transparent for particular index values,
respectively.
GLXTRANSPARENTINDEXVALUEEXT
Integer value between 0 and the maximum frame
buffer value for indices, indicating the
transparent index value for the frame buffer
configuration. Undefined if
GLXTRANSPARENTTYPEEXT is not
GLXTRANSPARENTINDEXEXT.
GLXTRANSPARENTREDVALUEEXT
Integer value between 0 and the maximum frame
buffer value for red, indicating the transparent
red value for the frame buffer configuration.
Undefined if GLXTRANSPARENTTYPEEXT is not
GLXTRANSPARENTRGBEXT.
GLXTRANSPARENTGREENVALUEEXT
Integer value between 0 and the maximum frame
buffer value for green, indicating the transparent
green value for the frame buffer configuration.
Undefined if GLXTRANSPARENTTYPEEXT is not
GLXTRANSPARENTRGBEXT.
GLXTRANSPARENTBLUEVALUEEXT
Integer value between 0 and the maximum frame
buffer value for blue, indicating the transparent
blue value for the frame buffer configuration.
Undefined if GLXTRANSPARENTTYPEEXT is not
GLXTRANSPARENTRGBEXT.
GLXTRANSPARENTALPHAVALUEEXT
Currently unused.
GLXVISUALCAVEATEXT One of GLXNONEEXT, GLXSLOWVISUALEXT,
GLXNONCONFORMANTEXT indicating that the frame
buffer configuration has no caveats, some aspect of
the frame buffer configuration runs slower than
other frame buffer configurations, or some aspect
of the frame buffer configuration is non-confomant,
respectively.
GLXDRAWABLETYPESGIX
Mask indicating what drawable types the frame
buffer configuration supports. Valid bits are
GLXWINDOWBITSGIX, GLXPIXMAPBITSGIX and
Page 3
glXGetFBConfigAttribSGIX(3G) OpenGL Reference - GLX
GLXPBUFFERBITSGIX.
GLXRENDERTYPESGIX Mask indicating what type of GLX contexts can be
made current to the frame buffer configuration.
Valid bits are GLXRGBABITSGIX and
GLXCOLORINDEXBITSGIX.
GLXXRENDERABLESGIX True if drawables created with the frame buffer
configuration can be rendered to by X.
GLXMAXPBUFFERWIDTHSGIX
The maximum width that can be specified to
glXCreateGLXPbufferSGIX.
GLXMAXPBUFFERHEIGHTSGIX
The maximum height that can be specified to
glXCreateGLXPbufferSGIX.
GLXMAXPBUFFERPIXELSSGIX
The maximum number of pixels (width times height)
for a pbuffer. Note that this value may be less
than GLXMAXPBUFFERWIDTHSGIX times
GLXMAXPBUFFERHEIGHTSGIX. Also, this value is
static and assumes that no other pbuffers or X
resources are contending for the framebuffer
memory. As a result, it may not be possible to
allocate a pbuffer of the size given by
GLXMAXPBUFFERPIXELSSGIX.
GLXOPTIMALPBUFFERWIDTHSGIX
The optimum width for a pbuffer.
GLXOPTIMALPBUFFERHEIGHTSGIX
The optimum height for a pbuffer.
Applications should choose the frame buffer configuration that most
closely meets their requirements. Creating windows, GLX pixmaps or GLX
pixel buffers with unnecessary buffers can result in reduced rendering
performance as well as poor resource allocation.
NOTES
glXGetFBConfigAttribSGIX is part of the GLXSGIXfbconfig extension.
glXGetFBConfigAttribSGIX is implemented as a client-side utility; it does
not require a round-trip to the X server.
GLXSAMPLEBUFFERSSGIS and GLXSAMPLESSGIS are not valid attributes
unless the SGISmultisample extension is supported.
Page 4
glXGetFBConfigAttribSGIX(3G) OpenGL Reference - GLX
GLXXVISUALTYPEEXT, GLXTRANSPARENTTYPEEXT,
GLXTRANSPARENTINDEXVALUEEXT, GLXTRANSPARENTREDVALUEEXT,
GLXTRANSPARENTGREENVALUEEXT, GLXTRANSPARENTBLUEVALUEEXT, and
GLXTRANSPARENTALPHAVALUEEXT are not valid attributes unless the
EXTvisualinfo extension is supported.
GLXVISUALCAVEATEXT is not a valid attribute unless the
EXTvisualrating extension is supported.
ERRORS
GLXNOEXTENSION is returned if dpy does not support the GLX extension.
GLXBADATTRIB is returned if attribute is not a valid GLX attribute.
MACHINE DEPENDENCIES
The SGISmultisample extension is supported only on RealityEngine,
RealityEngine2, and VTX systems and InfiniteReality systems.
SEE ALSO
glXGetConfig, glXChooseFBConfigSGIX, glXCreateGLXPixmapWithConfigSGIX,
glXCreateContextWithConfigSGIX, glXGetVisualFromFBConfigSGIX,
glXGetFBConfigFromVisualSGIX.
Page 5