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