glXCreateGLXPixmap Subroutine

OpenGL 1.1 for AIX: Reference Manual

glXCreateGLXPixmap Subroutine

Purpose

Creates an off-screen GLX rendering area.

Library

OpenGL C bindings library: libGL.a

C Syntax

GLXPixmap glXCreateGLXPixmap(Display *dpy
         XVisualInfo *Visual
         Pixmap Pixmap)

Description

The glXCreateGLXPixmap subroutine creates an off-screen rendering area and returns its XID. Any GLX rendering context that was created with respect to the Visual parameter can be used to render into this off-screen area. Use the glXMakeCurrent subroutine to associate the rendering area with a GLX rendering context.

The X pixmap identified by the Pixmap parameter is used as the front left buffer of the resulting off-screen rendering area. All other buffers specified by the Visual parameter, including color buffers (other than the front left buffer), are created without externally visible names. GLX pixmaps with double-buffering are supported. However, the glXSwapBuffers subroutine is ignored by these pixmaps.

Direct rendering contexts cannot be used to render into GLX pixmaps.

Parameters

dpy	Specifies the connection to the X server.
Visual	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 structure.
Pixmap	Specifies the X pixmap that is used as the front left color buffer of the off-screen rendering area.

Notes

XVisualInfo is defined in the Xutil.h file. It is a structure that includes Visual, VisualID, Screen, and Depth elements.

Error Codes

BadAlloc	Is generated if the server cannot allocate the GLX pixmap.
BadMatch	Is generated if one or more of the following is detected: the depth of Pixmap does not match the GLX_BUFFER_SIZE value of Visual, Pixmap was not created with respect to the same screen as Visual.
BadPixmap	Is generated if Pixmap is not a valid pixmap.
BadValue	Is generated if Visual is not a valid XVisualInfo pointer (for example, if the GLX implementation does not support this visual).

Files

/usr/include/GL/gl.h

Contains C language constants, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The glXCreateContext subroutine, glXIsDirect subroutine, glXMakeCurrent subroutine.

OpenGL in the AIXwindows (GLX) Environment.

OpenGL Overview.