11591693c7b415e9869157c711fe11263c95d74eDavid LiName
21591693c7b415e9869157c711fe11263c95d74eDavid Li
31591693c7b415e9869157c711fe11263c95d74eDavid Li    MESA_pixmap_colormap
41591693c7b415e9869157c711fe11263c95d74eDavid Li
51591693c7b415e9869157c711fe11263c95d74eDavid LiName Strings
61591693c7b415e9869157c711fe11263c95d74eDavid Li
71591693c7b415e9869157c711fe11263c95d74eDavid Li    GLX_MESA_pixmap_colormap
81591693c7b415e9869157c711fe11263c95d74eDavid Li
91591693c7b415e9869157c711fe11263c95d74eDavid LiContact
101591693c7b415e9869157c711fe11263c95d74eDavid Li
111591693c7b415e9869157c711fe11263c95d74eDavid Li    Brian Paul (brian.paul 'at' tungstengraphics.com)
121591693c7b415e9869157c711fe11263c95d74eDavid Li
131591693c7b415e9869157c711fe11263c95d74eDavid LiStatus
141591693c7b415e9869157c711fe11263c95d74eDavid Li
151591693c7b415e9869157c711fe11263c95d74eDavid Li    Shipping since Mesa 1.2.8 in May, 1996.
161591693c7b415e9869157c711fe11263c95d74eDavid Li
171591693c7b415e9869157c711fe11263c95d74eDavid LiVersion
181591693c7b415e9869157c711fe11263c95d74eDavid Li
191591693c7b415e9869157c711fe11263c95d74eDavid Li    Last Modified Date:  8 June 2000
201591693c7b415e9869157c711fe11263c95d74eDavid Li
211591693c7b415e9869157c711fe11263c95d74eDavid LiNumber
221591693c7b415e9869157c711fe11263c95d74eDavid Li
231591693c7b415e9869157c711fe11263c95d74eDavid Li    216
241591693c7b415e9869157c711fe11263c95d74eDavid Li
251591693c7b415e9869157c711fe11263c95d74eDavid LiDependencies
261591693c7b415e9869157c711fe11263c95d74eDavid Li
271591693c7b415e9869157c711fe11263c95d74eDavid Li    OpenGL 1.0 or later is required.
281591693c7b415e9869157c711fe11263c95d74eDavid Li    GLX 1.0 or later is required.
291591693c7b415e9869157c711fe11263c95d74eDavid Li
301591693c7b415e9869157c711fe11263c95d74eDavid LiOverview
311591693c7b415e9869157c711fe11263c95d74eDavid Li
321591693c7b415e9869157c711fe11263c95d74eDavid Li    Since Mesa allows RGB rendering into drawables with PseudoColor,
331591693c7b415e9869157c711fe11263c95d74eDavid Li    StaticColor, GrayScale and StaticGray visuals, Mesa needs a colormap
341591693c7b415e9869157c711fe11263c95d74eDavid Li    in order to compute pixel values during rendering.
351591693c7b415e9869157c711fe11263c95d74eDavid Li
361591693c7b415e9869157c711fe11263c95d74eDavid Li    The colormap associated with a window can be queried with normal
371591693c7b415e9869157c711fe11263c95d74eDavid Li    Xlib functions but there is no colormap associated with pixmaps.
381591693c7b415e9869157c711fe11263c95d74eDavid Li
391591693c7b415e9869157c711fe11263c95d74eDavid Li    The glXCreateGLXPixmapMESA function is an alternative to glXCreateGLXPixmap
401591693c7b415e9869157c711fe11263c95d74eDavid Li    which allows specification of a colormap.
411591693c7b415e9869157c711fe11263c95d74eDavid Li
421591693c7b415e9869157c711fe11263c95d74eDavid LiIP Status
431591693c7b415e9869157c711fe11263c95d74eDavid Li
441591693c7b415e9869157c711fe11263c95d74eDavid Li    Open-source; freely implementable.
451591693c7b415e9869157c711fe11263c95d74eDavid Li
461591693c7b415e9869157c711fe11263c95d74eDavid LiIssues
471591693c7b415e9869157c711fe11263c95d74eDavid Li
481591693c7b415e9869157c711fe11263c95d74eDavid Li    None.
491591693c7b415e9869157c711fe11263c95d74eDavid Li
501591693c7b415e9869157c711fe11263c95d74eDavid LiNew Procedures and Functions
511591693c7b415e9869157c711fe11263c95d74eDavid Li
521591693c7b415e9869157c711fe11263c95d74eDavid Li    GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
531591693c7b415e9869157c711fe11263c95d74eDavid Li				      Pixmap pixmap, Colormap cmap );
541591693c7b415e9869157c711fe11263c95d74eDavid Li
551591693c7b415e9869157c711fe11263c95d74eDavid LiNew Tokens
561591693c7b415e9869157c711fe11263c95d74eDavid Li
571591693c7b415e9869157c711fe11263c95d74eDavid Li    None.
581591693c7b415e9869157c711fe11263c95d74eDavid Li
591591693c7b415e9869157c711fe11263c95d74eDavid LiAdditions to Chapter 3 of the GLX 1.3 Specification (Functions and Errors)
601591693c7b415e9869157c711fe11263c95d74eDavid Li
611591693c7b415e9869157c711fe11263c95d74eDavid Li    Add to section 3.4.2 Off Screen Rendering
621591693c7b415e9869157c711fe11263c95d74eDavid Li
631591693c7b415e9869157c711fe11263c95d74eDavid Li    The Mesa implementation of GLX allows RGB rendering into X windows and
641591693c7b415e9869157c711fe11263c95d74eDavid Li    pixmaps of any visual class, not just TrueColor or DirectColor.  In order
651591693c7b415e9869157c711fe11263c95d74eDavid Li    to compute pixel values from RGB values Mesa requires a colormap.
661591693c7b415e9869157c711fe11263c95d74eDavid Li
671591693c7b415e9869157c711fe11263c95d74eDavid Li    The function
681591693c7b415e9869157c711fe11263c95d74eDavid Li
691591693c7b415e9869157c711fe11263c95d74eDavid Li	GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
701591693c7b415e9869157c711fe11263c95d74eDavid Li					  Pixmap pixmap, Colormap cmap );
711591693c7b415e9869157c711fe11263c95d74eDavid Li
721591693c7b415e9869157c711fe11263c95d74eDavid Li    allows one to create a GLXPixmap with a specific colormap.  The image
731591693c7b415e9869157c711fe11263c95d74eDavid Li    rendered into the pixmap may then be copied to a window (which uses the
741591693c7b415e9869157c711fe11263c95d74eDavid Li    same colormap and visual) with the expected results.
751591693c7b415e9869157c711fe11263c95d74eDavid Li
761591693c7b415e9869157c711fe11263c95d74eDavid LiGLX Protocol
771591693c7b415e9869157c711fe11263c95d74eDavid Li
781591693c7b415e9869157c711fe11263c95d74eDavid Li    None since this is a client-side extension.
791591693c7b415e9869157c711fe11263c95d74eDavid Li
801591693c7b415e9869157c711fe11263c95d74eDavid LiErrors
811591693c7b415e9869157c711fe11263c95d74eDavid Li
821591693c7b415e9869157c711fe11263c95d74eDavid Li    None.
831591693c7b415e9869157c711fe11263c95d74eDavid Li
841591693c7b415e9869157c711fe11263c95d74eDavid LiNew State
851591693c7b415e9869157c711fe11263c95d74eDavid Li
861591693c7b415e9869157c711fe11263c95d74eDavid Li    None.
871591693c7b415e9869157c711fe11263c95d74eDavid Li
881591693c7b415e9869157c711fe11263c95d74eDavid LiRevision History
891591693c7b415e9869157c711fe11263c95d74eDavid Li
901591693c7b415e9869157c711fe11263c95d74eDavid Li    8 June 2000 - initial specification
91