1Name
2
3    MESA_pixmap_colormap
4
5Name Strings
6
7    GLX_MESA_pixmap_colormap
8
9Contact
10
11    Brian Paul (brian.paul 'at' tungstengraphics.com)
12
13Status
14
15    Shipping since Mesa 1.2.8 in May, 1996.
16
17Version
18
19    Last Modified Date:  8 June 2000
20
21Number
22
23    216
24
25Dependencies
26
27    OpenGL 1.0 or later is required.
28    GLX 1.0 or later is required.
29
30Overview
31
32    Since Mesa allows RGB rendering into drawables with PseudoColor,
33    StaticColor, GrayScale and StaticGray visuals, Mesa needs a colormap
34    in order to compute pixel values during rendering.
35
36    The colormap associated with a window can be queried with normal
37    Xlib functions but there is no colormap associated with pixmaps.
38
39    The glXCreateGLXPixmapMESA function is an alternative to glXCreateGLXPixmap
40    which allows specification of a colormap.
41
42IP Status
43
44    Open-source; freely implementable.
45
46Issues
47
48    None.
49
50New Procedures and Functions
51
52    GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
53				      Pixmap pixmap, Colormap cmap );
54
55New Tokens
56
57    None.
58
59Additions to Chapter 3 of the GLX 1.3 Specification (Functions and Errors)
60
61    Add to section 3.4.2 Off Screen Rendering
62
63    The Mesa implementation of GLX allows RGB rendering into X windows and
64    pixmaps of any visual class, not just TrueColor or DirectColor.  In order
65    to compute pixel values from RGB values Mesa requires a colormap.
66
67    The function
68
69	GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
70					  Pixmap pixmap, Colormap cmap );
71
72    allows one to create a GLXPixmap with a specific colormap.  The image
73    rendered into the pixmap may then be copied to a window (which uses the
74    same colormap and visual) with the expected results.
75
76GLX Protocol
77
78    None since this is a client-side extension.
79
80Errors
81
82    None.
83
84New State
85
86    None.
87
88Revision History
89
90    8 June 2000 - initial specification
91