Subversion Repositories Kolibri OS

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
4358 Serge 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 
     and  indicates the lower-left corner of the region to copy and
69 
     and  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