• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    ARB_create_context_no_error
4
5Name Strings
6
7    WGL_ARB_create_context_no_error
8    GLX_ARB_create_context_no_error
9
10Contact
11
12    Piers Daniell (pdaniell 'at' nvidia.com)
13
14Contributors
15
16    Piers Daniell, NVIDIA
17    Daniel Koch, NVIDIA
18
19Notice
20
21    Copyright (c) 2017 The Khronos Group Inc. Copyright terms at
22        http://www.khronos.org/registry/speccopyright.html
23
24Specification Update Policy
25
26    Khronos-approved extension specifications are updated in response to
27    issues and bugs prioritized by the Khronos OpenGL Working Group. For
28    extensions which have been promoted to a core Specification, fixes will
29    first appear in the latest version of that core Specification, and will
30    eventually be backported to the extension document. This policy is
31    described in more detail at
32        https://www.khronos.org/registry/OpenGL/docs/update_policy.php
33
34Status
35
36    Complete. Approved by the OpenGL working group on March 31, 2017.
37    Approved by the Khronos Board of Promoters on May 26, 2017.
38
39Version
40
41    Last Modified Date:         2017-03-10
42    Author Revision:            2
43
44Number
45
46    ARB Extension #191
47
48Dependencies
49
50    WGL_ARB_create_context_no_error is written against the
51    WGL_ARB_create_context specification, which is required.
52
53    GLX_ARB_create_context_no_error is written against the GLX 1.4 and
54    GLX_ARB_create_context specifications. Both are required.
55
56Overview
57
58    This extension allows the creation of an OpenGL or OpenGL ES context that
59    doesn't generate errors if the context supports a no error mode.  The
60    implications of this feature are discussed in the GL_KHR_no_error
61    extension.
62
63New Procedures and Functions
64
65    None
66
67New Tokens (WGL)
68
69    Accepted as an attribute name in the <*attrib_list> argument to
70    wglCreateContextAttribsARB:
71
72        WGL_CONTEXT_OPENGL_NO_ERROR_ARB                     0x31B3
73
74New Tokens (GLX)
75
76    Accepted as an attribute name in the <*attrib_list> argument to
77    glXCreateContextAttribsARB:
78
79        GLX_CONTEXT_OPENGL_NO_ERROR_ARB                     0x31B3
80
81Additions to WGL_ARB_create_context and wglMakeCurrent
82
83    Add a new paragraph to the description of wglCreateContextAttribsARB, as
84    defined by WGL_ARB_create_context:
85
86    "The attribute name WGL_CONTEXT_OPENGL_NO_ERROR_ARB indicates whether a
87    faster and lower power mode should be enabled for the OpenGL or OpenGL ES
88    context.  In this mode instead of GL errors occurring as defined in the
89    OpenGL spec those errors will result in undefined behavior.  The default
90    value of WGL_CONTEXT_OPENGL_NO_ERROR_ARB is FALSE."
91
92Additions to the GLX 1.4 Specification and GLX_ARB_create_context
93
94    Add a new paragraph to the description of glXCreateContextAttribsARB,
95    as defined by GLX_ARB_create_context:
96
97    "The attribute name GLX_CONTEXT_OPENGL_NO_ERROR_ARB indicates whether a
98    faster and lower power mode should be enabled for the OpenGL or OpenGL ES
99    context.  In this mode instead of GL errors occurring as defined in the
100    OpenGL spec those errors will result in undefined behavior.  The default
101    value of WGL_CONTEXT_OPENGL_NO_ERROR_ARB is FALSE."
102
103GLX Protocol
104
105    TBD.
106
107Errors for WGL
108
109    ERROR_INCOMPATIBLE_DEVICE_CONTEXTS_ARB is generated if the value of
110    WGL_CONTEXT_OPENGL_NO_ERROR_ARB used to create <share_context> does not
111    match the value of WGL_CONTEXT_OPENGL_NO_ERROR_ARB for the context being
112    created.
113
114    ERROR_INCOMPATIBLE_DEVICE_CONTEXTS_ARB is generated if the
115    WGL_CONTEXT_OPENGL_NO_ERROR_ARB is TRUE at the same time as a debug or
116    robustness context is specified.
117
118Errors for GLX
119
120    BadMatch is generated if the value of GLX_CONTEXT_OPENGL_NO_ERROR_ARB
121    used to create <share_context> does not match the value of
122    GLX_CONTEXT_OPENGL_NO_ERROR_ARB for the context being created.
123
124    BadMatch is generated if the GLX_CONTEXT_OPENGL_NO_ERROR_ARB is TRUE at
125    the same time as a debug or robustness context is specified.
126
127New State
128
129    None.
130
131Issues
132
133    None
134
135Revision History
136
137 Rev.   Date      Author    Changes
138 ---- ----------  --------  ---------------------------------------------
139   1  2017-03-02  pdaniell  Initial draft
140   2  2017-03-10  pdaniell  Added errors
141   3  2017-03-27  pdaniell  Removed example section and added enum values
142