int glXGetFBConfigAttrib( Display *dpy,
GLXFBConfig confi )
PARAMETERS
dpy Specifies the connection to the X server.
confi Specifies the GLX frame buffer configuration to be queried.
_param3
Specifies the attribute to be returned.
_param4
Returns the requested value.
DESCRIPTION
glXGetFBConfigAttrib sets _param4 to the _param3 value of GLX drawables
created with respect to confi. glXGetFBConfigAttrib returns an error
code if it fails for any reason. Otherwise, Success is returned.
_param3 is one of the following:
GLX_FBCONFIG_ID XID of the given GLXFBConfig.
GLX_BUFFER_SIZE Number of bits per color buffer. If the frame
buffer configuration supports RGBA contexts, then
GLX_BUFFER_SIZE is the sum of GLX_RED_SIZE,
GLX_GREEN_SIZE, GLX_BLUE_SIZE, and GLX_ALPHA_SIZE.
If the frame buffer configuration supports only
color index contexts, GLX_BUFFER_SIZE is the size
of the color indexes.
GLX_LEVEL Frame buffer level of the configuration. Level
zero is the default frame buffer. Positive levels
correspond to frame buffers that overlay the de‐
fault buffer, and negative levels correspond to
frame buffers that underlie the default buffer.
GLX_DOUBLEBUFFER True if color buffers exist in front/back pairs
that can be swapped, False otherwise.
GLX_STEREO True if color buffers exist in left/right pairs,
False otherwise.
GLX_AUX_BUFFERS Number of auxiliary color buffers that are avail‐
able. Zero indicates that no auxiliary color buf‐
fers exist.
GLX_RED_SIZE Number of bits of red stored in each color buffer.
Undefined if RGBA contexts are not supported by
the frame buffer configuration.
GLX_GREEN_SIZE Number of bits of green stored in each color buf‐
GLX_ACCUM_RED_SIZE Number of bits of red stored in the accumulation
buffer.
GLX_ACCUM_GREEN_SIZE Number of bits of green stored in the accumulation
buffer.
GLX_ACCUM_BLUE_SIZE Number of bits of blue stored in the accumulation
buffer.
GLX_ACCUM_ALPHA_SIZE Number of bits of alpha stored in the accumulation
buffer.
GLX_RENDER_TYPE Mask indicating what type of GLX contexts can be
made current to the frame buffer configuration.
Valid bits are GLX_RGBA_BIT and
GLX_COLOR_INDEX_BIT.
GLX_DRAWABLE_TYPE Mask indicating what drawable types the frame buf‐
fer configuration supports. Valid bits are
GLX_WINDOW_BIT, GLX_PIXMAP_BIT, and
GLX_PBUFFER_BIT.
GLX_X_RENDERABLE True if drawables created with the frame buffer
configuration can be rendered to by X.
GLX_VISUAL_ID XID of the corresponding visual, or zero if there
is no associated visual (i.e., if GLX_X_RENDERABLE
is False or GLX_DRAWABLE_TYPE does not have the
GLX_WINDOW_BIT bit set.)
GLX_X_VISUAL_TYPE Visual type of associated visual. The returned
value will be one of: GLX_TRUE_COLOR,
GLX_DIRECT_COLOR, GLX_PSEUDO_COLOR,
GLX_STATIC_COLOR, GLX_GRAY_SCALE, GLX_STATIC_GRAY,
or GLX_NONE, if there is no associated visual
(i.e., if GLX_X_RENDERABLE is False or
GLX_DRAWABLE_TYPE does not have the GLX_WINDOW_BIT
bit set.)
GLX_CONFIG_CAVEAT One of GLX_NONE, GLX_SLOW_CONFIG, or
GLX_NON_CONFORMANT_CONFIG, 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
nonconformant, respectively.
GLX_TRANSPARENT_TYPE One of GLX_NONE, GLX_TRANSPARENT_RGB,
GLX_TRANSPARENT_INDEX, indicating that the frame
buffer configuration is opaque, is transparent for
particular values of red, green, and blue or is
fined if GLX_TRANSPARENT_TYPE is not
GLX_TRANSPARENT_RGB.
GLX_TRANSPARENT_GREEN_VALUE
Integer value between 0 and the maximum frame buf‐
fer value for green, indicating the transparent
green value for the frame buffer configuration.
Undefined if GLX_TRANSPARENT_TYPE is not
GLX_TRANSPARENT_RGB.
GLX_TRANSPARENT_BLUE_VALUE
Integer value between 0 and the maximum frame buf‐
fer value for blue, indicating the transparent
blue value for the frame buffer configuration.
Undefined if GLX_TRANSPARENT_TYPE is not
GLX_TRANSPARENT_RGB.
GLX_TRANSPARENT_ALPHA_VALUE
Integer value between 0 and the maximum frame buf‐
fer value for alpha, indicating the transparent
blue value for the frame buffer configuration.
Undefined if GLX_TRANSPARENT_TYPE is not
GLX_TRANSPARENT_RGB.
GLX_MAX_PBUFFER_WIDTH The maximum width that can be specified to
glCreateGLXPbuffer.
GLX_MAX_PBUFFER_HEIGHT
The maximum height that can be specified to
glCreateGLXPbuffer.
GLX_MAX_PBUFFER_PIXELS
The maximum number of pixels (width times height)
for a pixel buffer. Note that this value may be
less than GLX_MAX_PBUFFER_WIDTH times
GLX_MAX_PBUFFER_HEIGHT. Also, this value is static
and assumes that no other pixel buffers or X re‐
sources are contending for the frame buffer mem‐
ory. As a result, it may not be possible to allo‐
cate a pixel buffer of the size given by
GLX_MAX_PBUFFER_PIXELS.
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
glXGetFBConfigAttrib is available only if the GLX version is 1.3 or
greater.
If the GLX version is 1.1 or 1.0, the GL version must be 1.0. If the
Man(1) output converted with
man2html