1GLXCREATEGLXPIXMAP()                                      GLXCREATEGLXPIXMAP()
2
3
4

NAME

6       glXCreateGLXPixmap - create an off-screen GLX rendering area
7
8

C SPECIFICATION

10       GLXPixmap glXCreateGLXPixmap( Display *dpy,
11                                     XVisualInfo *vis,
12                                     Pixmap pixmap )
13
14       delim $$
15

PARAMETERS

17       dpy     Specifies the connection to the X server.
18
19       vis     Specifies  the visual that defines the structure of the render‐
20               ing area.  It is a pointer to an XVisualInfo structure,  not  a
21               visual ID or a pointer to a Visual.
22
23       pixmap  Specifies  the  X  pixmap  that  will be used as the front left
24               color buffer of the off-screen rendering area.
25

DESCRIPTION

27       glXCreateGLXPixmap creates an off-screen rendering area and returns its
28       XID.   Any  GLX  rendering context that was created with respect to vis
29       can be used to render into this off-screen area.  Use glXMakeCurrent to
30       associate the rendering area with a GLX rendering context.
31
32       The  X  pixmap identified by pixmap is used as the front left buffer of
33       the resulting off-screen rendering area.  All other  buffers  specified
34       by  vis,  including color buffers other than the front left buffer, are
35       created without externally visible names.   GLX  pixmaps  with  double-
36       buffering  are  supported.  However, glXSwapBuffers is ignored by these
37       pixmaps.
38
39       Some implementations may not support GLX pixmaps with direct  rendering
40       contexts.
41

NOTES

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

ERRORS

47       BadMatch is generated if the depth of pixmap does not match  the  depth
48       value  reported  by core X11 for vis, or if pixmap was not created with
49       respect to the same screen as vis.
50
51       BadValue is generated if vis is not a valid  XVisualInfo  pointer  (for
52       example,  if a particular GLX implementation does not support this vis‐
53       ual).
54
55       BadPixmap is generated if pixmap is not a valid pixmap.
56
57       BadAlloc is generated if the server cannot allocate the GLX pixmap.
58

SEE ALSO

60       glXCreateContext, glXIsDirect, glXMakeCurrent
61
62
63
64                                                          GLXCREATEGLXPIXMAP()