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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- The root element should be <draft href="~~"> for draft extensions -->
<!-- The root element should be <proposal href="~~"> for proposed extensions -->
<!-- The root element should be <ratified href="~~"> for ratified extensions -->
<!-- @href should be a URI relative to the WebGL extension registry at
http://www.khronos.org/registry/webgl/extensions/
-->
<extension href="template/">
<!-- The name of the extension. This is also the string which is passed to the
WebGLRenderingContext getExtension API to enable the extension. For example, if
the extension were OES_texture_float, then the extension would be fetched and
enabled with a call to getExtension("OES_texture_float")
Per WebGL convention, the 'GL_' prefix is dropped from all extension and enum
names, and the 'gl' prefix dropped from, and capitalization adjusted of, all
function names.
-->
<name>template</name>
<!-- The optional alternate name strings of the extension for draft exts -->
<aliases>
<alias>VENDOR_EXT_NAME</alias>
<alias>VENDOR_EXT_NAME</alias>
</aliases>
<!-- the email address of the contact of the specification -->
<!-- prefer to 'at' instead of the '@' character to reduce spam -->
<contact> <a href="https://www.khronos.org/webgl/public-mailing-list/">WebGL
working group</a> (public_webgl 'at' khronos.org) </contact>
<!-- Names and email addresses of individuals who contributed to the development of
the specification
-->
<contributors>
<contributor>Members of the WebGL working group</contributor>
</contributors>
<number>k <!-- extension number in registry --></number>
<depends>
<api version="1.0"/>
<core version="2.0"/>
<!-- Version in which the extension functionality was integrated into the core spec -->
<core version="2.0">
<glsl version="300 es"/>
<!-- GLSL #version required to use the feature, if any -->
<addendum> Difference in core spec from extension. </addendum>
</core>
<removed version="2.0"/>
<!-- Version as of which extension is no longer supported -->
<ext name="WEBGL_required_ext" require="true"/>
<ext name="WEBGL_base_ext"/>
<!-- api/extension with hyperlink -->
</depends>
<overview>
<!-- use mirrors if this extension wraps another -->
<mirrors href="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_float.txt"
name="OES_texture_float">
<!-- list the deviations here if there are any -->
<addendum>Optional support for <code>FLOAT</code> textures as FBO
attachments.</addendum>
<!-- Tags not 'addendum' replace the default text that says
"Consult the above extension for documentation, issues and new functions and enumerants."
-->
</mirrors>
<!-- normal free-form XHTML is allowed here -->
<div class="nonnormative">
<p> This template for WebGL extensions is derived from the <a
href="http://www.opengl.org/registry/doc/template/txt">OpenGL extension
template</a>. Refer to the OpenGL extension template for full
documentation of the content that should be contained in the sections
below. Because WebGL is fundamentally a Web API, its extensions are
specified in XML transformed with XSLT into HTML for easier
hyperlinking. </p>
<p> Because most WebGL extensions are expected to simply mirror existing
OpenGL and OpenGL ES extensions, it is desirable to keep the WebGL
extension specifications as small as possible and simply refer to the
other specifications for the behavioral definitions. </p>
</div>
<features>
<!-- a list of features in XHTML -->
<feature>Frobs the <b>baz</b></feature>
<!-- can also specify glsl built-ins in structured format -->
<glsl extname="GL_OES_foo_bar">
<alias extname="GL_NV_foo_bar"/>
<alias extname="GL_ATI_foo_bar"/>
<stage type="fragment"/>
<stage type="vertex"/>
<function name="myfun" type="vec4">
<param type="vec4"/>
</function>
</glsl>
</features>
</overview>
<idl xml:space="preserve"> <!-- copied literally into a <pre> -->
<!-- Enums and functions introduced by the extension should be specified as
'const GLenum' and methods on the extension object. The extension IDL should
be written assuming that the typedefs in
<a href="../../specs/latest/webgl.idl">webgl.idl</a> and
<a href="../../typedarray/specs/latest/typedarrays.idl">typedarrays.idl</a>
have already been defined, and may implicitly reference other web platform
specifications.
-->
module webgl {
interface OES_foo_bar {
const GLenum NEW_ENUM = 0xF00;
void doSomethingNew(GLenum state, GLuint value);
}; // interface OES_foo_bar
}; // module webgl
</idl>
<!-- new functions -->
<newfun>
<function name="loseContext" type="void"> XHTML description </function>
</newfun>
<!-- new types -->
<newtypes>
<typedef name="in_pipe"> <type>unsigned long long</type> XHTML </typedef>
<typedef name="out_pipe"> <type>unsigned long long</type> XHTML </typedef>
<interface name="Plumber">
<member>Plumber work(in_pipe,out_pipe);</member>
<p>After attempting a connection, the plumber is no longer the same.</p>
</interface>
<interface name="Agency" noobject="true"> <member>void
register(Plumber);</member> <member>Plumber find();</member> XHTML
</interface>
</newtypes>
<!-- new tokens -->
<newtok>
<function name="getParameter" type="any"> <param name="pname"
type="GLenum"/> XHTML </function>
</newtok>
<!-- Refer to the <http://www.opengl.org/registry/doc/template.txt> OpenGL
extension template for a description of these sections. These sections
should be eliminated for WebGL extensions simply mirroring OpenGL or
OpenGL ES extensions.
-->
<!-- these take XHTML markup as contents -->
<security/>
<ipstatus/>
<additions/>
<!-- Additions to the WebGL Specification -->
<errors/>
<newstate/>
<newimplstate/>
<!-- New Implementation-Dependent State -->
<samplecode/>
<tests/>
<issues/>
<history>
<!-- a list of revisions in any order -->
<!-- Include important changes in the evolution of the extension. It's
especially important to include this section if the extension is modified
after a version has been shipped. Consult the
<http://www.opengl.org/registry/doc/template.txt> OpenGL extension template
for an example.
-->
<revision date="YYYY/MM/DD">
<!-- a list of changes -->
<change>Quuxed the bar</change>
<change>Fooed the frob</change>
</revision>
</history>
</extension>
|
