glXCreateGLXPixmap: create an off-screen GLX rendering area.
C Specification |
glXCreateGLXPixmap creates an off-screen rendering area and returns
its XID. Any GLX rendering context that was created with respect to
vis can be used to render into this off-screen area. Use glXMakeCurrent to associate the
rendering area with a GLX rendering context.
- Specifies the connection to the X server.
- Specifies the visual that defines the structure of the rendering area. It
is a pointer to an XVisualInfo structure, not a visual ID or a
pointer to a Visual.
- Specifies the X pixmap that will be used as the front left color buffer of
the off-screen rendering area.
The X pixmap identified by pixmap is used as the front left
buffer of the resulting off-screen rendering area. All other buffers
specified by vis, including color buffers other than the front
left buffer, are created without externally visible names. GLX pixmaps with
double-buffering are supported. However, glXSwapBuffers is ignored by these
Some implementations may not support GLX pixmaps with direct rendering
XVisualInfo is defined in Xutil.h.. It is a
structure that includes visual, visualID,
screen, and depth elements.
- BadMatch is generated if the depth of
pixmap does not match the depth value reported by core X11
for vis, or if pixmap was not created with
respect to the same screen as vis.
- BadValue is generated if vis is not a
valid XVisualInfo pointer (for example, if a particular GLX implementation
does not support this visual).
- BadPixmap is generated if pixmap is not a
- BadAlloc is generated if the server cannot allocate the