1991-2006
Silicon Graphics, Inc.
glXCreateGLXPixmap
3G

# glXCreateGLXPixmap

create an off-screen GLX rendering area

## C Specification

                    GLXPixmap glXCreateGLXPixmap
                    Display * dpy
                    XVisualInfo * vis
                    Pixmap pixmap

## Parameters

`dpy`

  Specifies the connection to the X server.

`vis`

  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`.

`pixmap`

  Specifies the X pixmap that will be used as the front left color buffer of the off-screen rendering area.

## Description

`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.

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 pixmaps.

Some implementations may not support GLX pixmaps with direct rendering contexts.

## Notes

`XVisualInfo` is defined in Xutil.h. It is a structure that includes visual, visualID, screen, and depth elements.

## Errors

`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 valid pixmap.

`BadAlloc` is generated if the server cannot allocate the GLX pixmap.

## See Also

glXCreateContext, glXCreatePixmap, glXDestroyGLXPixmap, glXIsDirect, glXMakeCurrent

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.