GLXFBConfig confi )
PARAMETERS
dpy Specifies the connection to the X server.
confi Specifies a GLXFBConfig structure with the desired attributes for
the window.
_param3
Specifies a list of attribute value pairs, which must be termi‐
nated with None, or NULL. Accepted attributes are
GLX_PBUFFER_WIDTH, GLX_PBUFFER_HEIGHT, GLX_PRESERVED_CONTENTS,
and GLX_LARGEST_PBUFFER.
DESCRIPTION
glXCreatePbuffer creates an off-screen rendering area and returns its
XID. Any GLX rendering context that was created with respect to confi
can be used to render into this window. Use glXMakeContextCurrent to
associate the rendering area with a GLX rendering context.
The accepted attributes for a GLXPbuffer are:
GLX_PBUFFER_WIDTH Specify the pixel width of the requested GLXP‐
buffer. The default value is 0.
GLX_PBUFFER_HEIGHT Specify the pixel height of the requested GLXP‐
buffer. The default value is 0.
GLX_LARGEST_PBUFFER Specify to obtain the largest available pixel buf‐
fer, if the requested allocation would have
failed. The width and height of the allocated
pixel buffer will never exceed the specified
GLX_PBUFFER_WIDTH or GLX_PBUFFER_HEIGHT, respec‐
tively. Use glXQueryDrawable to retrieve the di‐
mensions of the allocated pixel buffer. The de‐
fault value is False.
GLX_PRESERVED_CONTENTS
Specify if the contents of the pixel buffer should
be preserved when a resource conflict occurs. If
set to False, the contents of the pixel buffer may
be lost at any time. If set to True, or not spec‐
ified in _param3, then the contents of the pixel
buffer will be preserved (most likely by copying
the contents into main system memory from the
frame buffer). In either case, the client can
register (using glXSelectEvent, to receive pixel
buffer clobber events which are generated when the
pbuffer contents have been preserved or damaged.
GLXPbuffers contain the color and ancillary buffers specified by confi.
It is possible to create a pixel buffer with back buffers, and swap
the requested GLXPbuffer.
GLXBadFBConfig is generated if confi is not a valid GLXFBConfig.
BadMatch is generated if confi does not support rendering to pixel buf‐
fers. (e.g., GLX_DRAWABLE_TYPE does not contain GLX_PBUFFER_BIT).
SEE ALSO
glXChooseFBConfig, glXCreatePbuffer, glXMakeContextCurrent,
glXSelectEvent
GLXCREATEPBUFFER(3G)
Man(1) output converted with
man2html