Home | History | Annotate | Download | only in docs
      1 Name
      2 
      3     MESA_release_buffers
      4 
      5 Name Strings
      6 
      7     GLX_MESA_release_buffers
      8 
      9 Contact
     10 
     11     Brian Paul (brian.paul 'at' tungstengraphics.com)
     12 
     13 Status
     14 
     15     Shipping since Mesa 2.0 in October, 1996.
     16 
     17 Version
     18 
     19     Last Modified Date:  8 June 2000
     20 
     21 Number
     22 
     23     217
     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     Mesa's implementation of GLX is entirely implemented on the client side.
     33     Therefore, Mesa cannot immediately detect when an X window or pixmap is
     34     destroyed in order to free any ancillary data associated with the window
     35     or pixmap.
     36 
     37     The glxMesaReleaseBuffers() function can be used to explicitly indicate
     38     when the back color buffer, depth buffer, stencil buffer, and/or accumu-
     39     lation buffer associated with a drawable can be freed.
     40 
     41 IP Status
     42 
     43     Open-source; freely implementable.
     44 
     45 Issues
     46 
     47     None.
     48 
     49 New Procedures and Functions
     50 
     51     Bool glXReleaseBuffersMESA( Display *dpy, GLXDrawable d );
     52 
     53 New Tokens
     54 
     55     None.
     56 
     57 Additions to Chapter 3 of the GLX 1.3 Specification (Functions and Errors)
     58 
     59     The function
     60 
     61 	Bool glXReleaseBuffersMESA( Display *dpy, GLXDrawable d );
     62 
     63     causes all software ancillary buffers (back buffer, depth, stencil,
     64     accum, etc) associated with the named drawable to be immediately
     65     deallocated.  True is returned if <d> is a valid Mesa GLX drawable,
     66     else False is returned.  After calling glXReleaseBuffersMESA, the
     67     drawable should no longer be used for GL rendering.  Results of
     68     attempting to do so are undefined.
     69 
     70 
     71 GLX Protocol
     72 
     73     None, since this is a client-side operation.
     74 
     75 Errors
     76 
     77     None.
     78 
     79 New State
     80 
     81     None.
     82 
     83 Revision History
     84 
     85     8 June 2000 - initial specification
     86