"Fossies" - the Fresh Open Source Software Archive

Member "mesa-20.1.8/docs/specs/MESA_copy_sub_buffer.spec" (16 Sep 2020, 2288 Bytes) of package /linux/misc/mesa-20.1.8.tar.xz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) RPM Spec source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 Name
    2 
    3     MESA_copy_sub_buffer
    4 
    5 Name Strings
    6 
    7     GLX_MESA_copy_sub_buffer
    8 
    9 Contact
   10 
   11     Brian Paul (brian.paul 'at' tungstengraphics.com)
   12 
   13 Status
   14 
   15     Shipping since Mesa 2.6 in February, 1998.
   16 
   17 Version
   18 
   19     Last Modified Date:  12 January 2009
   20 
   21 Number
   22 
   23     215
   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     The glxCopySubBufferMESA() function copies a rectangular region
   33     of the back color buffer to the front color buffer.  This can be
   34     used to quickly repaint 3D windows in response to expose events
   35     when the back color buffer cannot be damaged by other windows.
   36 
   37 IP Status
   38 
   39     Open-source; freely implementable.
   40 
   41 Issues
   42 
   43     None.
   44 
   45 New Procedures and Functions
   46 
   47     void glXCopySubBufferMESA( Display *dpy, GLXDrawable drawable,
   48                    int x, int y, int width, int height );
   49 
   50 New Tokens
   51 
   52     None.
   53 
   54 Additions to Chapter 3 of the GLX 1.3 Specification (Functions and Errors)
   55 
   56     Add to section 3.3.10 Double Buffering:
   57 
   58     The function
   59 
   60      void glXCopySubBufferMESA( Display *dpy, GLXDrawable drawable,
   61                     int x, int y, int width, int height );
   62 
   63     may be used to copy a rectangular region of the back color buffer to
   64     the front color buffer.  This can be used to quickly repaint 3D windows
   65     in response to expose events when the back color buffer cannot be
   66     damaged by other windows.
   67 
   68     <x> and <y> indicates the lower-left corner of the region to copy and
   69     <width> and <height> indicate the size in pixels.  Coordinate (0,0)
   70     corresponds to the lower-left pixel of the window, like glReadPixels.
   71 
   72     If dpy and drawable are the display and drawable for the calling
   73     thread's current context, glXCopySubBufferMESA performs an
   74     implicit glFlush before it returns.  Subsequent OpenGL commands
   75     may be issued immediately after calling glXCopySubBufferMESA, but
   76     are not executed until the copy is completed. 
   77 
   78 GLX Protocol
   79 
   80     None at this time.  The extension is implemented in terms of ordinary
   81     Xlib protocol inside of Mesa.
   82 
   83 Errors
   84 
   85     None.
   86 
   87 New State
   88 
   89     None.
   90 
   91 Revision History
   92 
   93     12 January 2009 Ian Romanick - Added language about implicit flush
   94                                    and command completion.
   95     8 June 2000     Brian Paul   - initial specification
   96