Subversion Repositories Kolibri OS

Rev

Go to most recent revision | Blame | Last modification | View Log | RSS feed

  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.  
  97.