• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    GLX_OML_swap_method
4
5Name Strings
6
7    GLX_OML_swap_method
8
9Contact
10
11    Jon Leech, SGI (ljp 'at' sgi.com)
12
13Status
14
15    Complete. Approved by the Khronos SIG on July 19, 2001.
16
17Version
18
19    Last Modified Date: 07/23/2001
20    Revision: $Header: //depot/main/doc/registry/extensions/OML/glx_swap_method.spec#4 $
21
22Number
23
24    237
25
26Dependencies
27
28    GLX 1.3 is required.
29
30Overview
31
32    This extension adds a new attribute, GLX_SWAP_METHOD, for a
33    GLXFBConfig. The GLX_SWAP_METHOD indicates how front and back
34    buffers are swapped when the GLXFBConfig is double-buffered.
35
36IP Status
37
38    No known issues.
39
40Issues and Notes
41
42  * Some hardware supports different swap methods in full screen mode
43    vs. windowed mode. How should this be handled? This is not handled
44    by this extension. GLX does not support the notion of fullscreen vs.
45    windowed mode. A separate extension is required to properly support
46    fullscreen mode.
47
48New Procedures and Functions
49
50    None.
51
52New Tokens
53
54    Accepted in the <attrib_list> parameter array of glXChooseFBConfig
55    and as the <attribute> parameter for glXGetFBConfigAttrib:
56
57	GLX_SWAP_METHOD_OML		    0x8060
58
59Accepted as a value in the <attrib_list> parameter of glXChooseFBConfig
60and returned in the <value> parameter of glXGetFBConfig:
61
62	GLX_SWAP_EXCHANGE_OML		    0x8061
63	GLX_SWAP_COPY_OML		    0x8062
64	GLX_SWAP_UNDEFINED_OML		    0x8063
65
66Additions to the OpenGL 1.2.1 Specification
67
68    None
69
70Additions to the GLX 1.3 Specification
71
72  - (3.3.3, p. ?? "Configuration Management")
73
74    Add to table 3.1:
75
76    Attribute		 Type Notes
77    ---------		 ---- -----
78    GLX_SWAP_METHOD_OML  enum method used to swap front and back color buffers
79
80
81    The GLX_SWAP_METHOD_OML attribute may be set to one of the following
82    values: GLX_SWAP_EXCHANGE_OML, GLX_SWAP_COPY_OML or
83    GLX_SWAP_UNDEFINED_OML. If this attribute is set to
84    GLX_SWAP_EXCHANGE_OML then swapping exchanges the front and back
85    buffer contents; if the attribute is set to GLX_SWAP_COPY_OML then
86    swapping copies the back buffer contents to the front buffer,
87    preserving the back buffer contents; if it is set to
88    GLX_SWAP_UNDEFINED_OML then the back buffer contents are copied to
89    the front buffer but the back buffer contents are undefined after
90    the operation. If the GLXFBConfig does not support a back buffer,
91    then the value of GLX_SWAP_METHOD_OML is set to
92    GLX_SWAP_UNDEFINED_OML.
93
94    Add to table 3.4:
95
96    Attribute		Default		Selection and Sorting	Sort Priority
97					Criteria
98    ---------		-------		---------------------	-------------
99    GLX_SWAP_METHOD_OML GLX_DONT_CARE	Exact			???
100
101New State
102
103    None
104
105New Implementation Dependent State
106
107    None
108
109Revision History
110
111    Revision 4, 07/24/2001 - Finalized Status for OpenML 1.0.
112    Revision 3, 07/11/2001 - Assign enum values.
113    Revision 2, 07/11/2001 - Assign extension numbers for the registry.
114    Revision 1 - change Paula's draft to use OML affix.
115