forked from google/angle
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathANGLE_request_extension.txt
116 lines (70 loc) · 3.33 KB
/
ANGLE_request_extension.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
Name
ANGLE_request_extension
Name Strings
GL_ANGLE_request_extension
Contributors
Geoff Lang
Contact
Geoff Lang (geofflang 'at' google.com)
Notice
Copyright (c) 2016 The Khronos Group Inc. Copyright terms at
http://www.khronos.org/registry/speccopyright.html
Status
Draft
Version
Version 1, November 28, 2016
Number
OpenGL ES Extension #??
Dependencies
Requires OpenGL ES 2.0
Written against the OpenGL ES 3.0 specification.
Overview
This extension allows the client to query extensions that can be enabled and
explicitly request than an extension be enabled.
New Procedures and Functions
void RequestExtension(const char *name)
New Tokens
Accepted by the <name> parameter of GetString and GetStringi:
REQUESTABLE_EXTENSIONS_ANGLE 0x93A8
Accepted by the <value> parameter of the GetInteger* functions:
NUM_REQUESTABLE_EXTENSIONS_ANGLE 0x93A9
Additions to the OpenGL ES 3.0 Specification
Add the following paragraph to the end paragraph 4 of section 6.1.6, String
Queries:
"REQUESTABLE_EXTENSIONS_ANGLE returns a list of extensions that can be
enabled at runtime by calling RequestExtension."
Change the following section of paragraph 6 of section 6.1.6, String Queries:
- "name may only be EXTENSIONS, indicating that the extension name
- corresponding to the indexth supported extension should be returned.
- <index> may range from zero to the value of NUM_EXTENSIONS minus one"
+ "name may be EXTENSIONS or REQUESTABLE_EXTENSIONS_ANGLE, indicating that
+ the extension name corresponding to the indexth supported or requestable
+ extension should be returned. <index> may range from zero to the value of
+ NUM_EXTENSIONS and NUM_REQUESTABLE_EXTENSIONS_ANGLE minus one"
The command
void RequestExtension(const char *name)
enables the requestable OpenGL ES extension named <name>. If the extension
was not requestable, INVALID_OPERATION is generated.
New State
Add to Table 6.30 (Implementation Dependent Version and Extension Support)
Get value Type Get Cmd Min Value Description Sec.
-------------------------------- ---- ----------- --------- -------------------------------- -----
NUM_REQUESTABLE_EXTENSIONS_ANGLE Z+ GetIntegerv - Number of individual requestable 6.1.6
extension names
Interactions with the OpenGL ES 2.0 specification:
Remove all references to GetStringi and NUM_REQUESTABLE_EXTENSIONS_ANGLE.
Issues
(1) How can the user determine which extensions can be enabled without
potentially generating errors?
This can be solved by:
a) Never generate an error in EnableExtensions, simply return false when
the extension is not recognized or cannot be enabled.
b) Add another query for the extensions that the context supports
enabling.
RESOLVED: Use (b) because it allows the context to explicity advertise
which extensions support enabling and doesn't generate errors in the
normal use case.
Revision History
Rev. Date Author Changes
---- ------------- --------- ----------------------------------------
1 Nov 28, 2016 geofflang Initial version