17b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulName
27b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
3dd18a4f335984081ccf5c2145b7983168ab3e074Brian Paul    MESA_pixmap_colormap
47b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
57b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulName Strings
67b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
7dd18a4f335984081ccf5c2145b7983168ab3e074Brian Paul    GLX_MESA_pixmap_colormap
87b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
97b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulContact
107b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
11d3b09fe29b112ddf114d14849e917befafd8387aBrian Paul    Brian Paul (brian.paul 'at' tungstengraphics.com)
127b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
137b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulStatus
147b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
157b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    Shipping since Mesa 1.2.8 in May, 1996.
167b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
177b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulVersion
187b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
197b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    Last Modified Date:  8 June 2000
207b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
217b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulNumber
227b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
23dd18a4f335984081ccf5c2145b7983168ab3e074Brian Paul    216
247b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
257b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulDependencies
267b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
277b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    OpenGL 1.0 or later is required.
287b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    GLX 1.0 or later is required.
297b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
307b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulOverview
317b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
327b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    Since Mesa allows RGB rendering into drawables with PseudoColor,
337b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    StaticColor, GrayScale and StaticGray visuals, Mesa needs a colormap
347b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    in order to compute pixel values during rendering.
357b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
367b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    The colormap associated with a window can be queried with normal
377b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    Xlib functions but there is no colormap associated with pixmaps.
387b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
397b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    The glXCreateGLXPixmapMESA function is an alternative to glXCreateGLXPixmap
407b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    which allows specification of a colormap.
417b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
427b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulIP Status
437b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
447b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    Open-source; freely implementable.
457b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
467b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulIssues
477b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
487b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    None.
497b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
507b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulNew Procedures and Functions
517b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
527b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
53dd18a4f335984081ccf5c2145b7983168ab3e074Brian Paul				      Pixmap pixmap, Colormap cmap );
547b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
557b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulNew Tokens
567b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
577b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    None.
587b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
597b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulAdditions to Chapter 3 of the GLX 1.3 Specification (Functions and Errors)
607b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
617b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    Add to section 3.4.2 Off Screen Rendering
627b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
637b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    The Mesa implementation of GLX allows RGB rendering into X windows and
647b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    pixmaps of any visual class, not just TrueColor or DirectColor.  In order
657b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    to compute pixel values from RGB values Mesa requires a colormap.
667b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
677b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    The function
687b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
69dd18a4f335984081ccf5c2145b7983168ab3e074Brian Paul	GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
70dd18a4f335984081ccf5c2145b7983168ab3e074Brian Paul					  Pixmap pixmap, Colormap cmap );
717b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
727b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    allows one to create a GLXPixmap with a specific colormap.  The image
737b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    rendered into the pixmap may then be copied to a window (which uses the
747b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    same colormap and visual) with the expected results.
757b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
767b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulGLX Protocol
777b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
787b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    None since this is a client-side extension.
797b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
807b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulErrors
817b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
827b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    None.
837b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
847b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulNew State
857b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
867b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    None.
877b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
887b2c0f9148eb7eb30326173899ed366fcef8d437Brian PaulRevision History
897b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul
907b2c0f9148eb7eb30326173899ed366fcef8d437Brian Paul    8 June 2000 - initial specification
91