Home | History | Annotate | Download | only in docs 
      1 Name
      2 
      3     MESA_pixmap_colormap
      4 
      5 Name Strings
      6 
      7     GLX_MESA_pixmap_colormap
      8 
      9 Contact
     10 
     11     Brian Paul (brian.paul 'at' tungstengraphics.com)
     12 
     13 Status
     14 
     15     Shipping since Mesa 1.2.8 in May, 1996.
     16 
     17 Version
     18 
     19     Last Modified Date:  8 June 2000
     20 
     21 Number
     22 
     23     216
     24 
     25 Dependencies
     26 
     27     OpenGL 1.0 or later is required.
     28     GLX 1.0 or later is required.
     29 
     30 Overview
     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 
     42 IP Status
     43 
     44     Open-source; freely implementable.
     45 
     46 Issues
     47 
     48     None.
     49 
     50 New Procedures and Functions
     51 
     52     GLXPixmap glXCreateGLXPixmapMESA( Display *dpy, XVisualInfo *visual,
     53 				      Pixmap pixmap, Colormap cmap );
     54 
     55 New Tokens
     56 
     57     None.
     58 
     59 Additions 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 
     76 GLX Protocol
     77 
     78     None since this is a client-side extension.
     79 
     80 Errors
     81 
     82     None.
     83 
     84 New State
     85 
     86     None.
     87 
     88 Revision History
     89 
     90     8 June 2000 - initial specification
     91