OLD | NEW |
| (Empty) |
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" | |
2 "http://www.w3.org/TR/html4/strict.dtd"> | |
3 <html lang="en"> | |
4 <head> | |
5 <meta http-equiv="content-type" content="text/html; charset=utf-8"> | |
6 <title>WebGL Extension Template</title> | |
7 <link rel="stylesheet" type="text/css" href="../../resources/webgl-extension
.css" /> | |
8 <link rel="stylesheet" type="text/css" href="../../resources/default.css" /> | |
9 <script src="../../resources/jquery-1.3.2.min.js" type="text/javascript"></s
cript> | |
10 </head> | |
11 <!--begin-logo--> | |
12 <div> | |
13 <a href="http://webgl.org/"><img alt=WebGL height=72 src="../../resources/
WebGL-Logo.png" width=156></a> | |
14 <div class=right> | |
15 <a href="http://khronos.org/"><img alt=Khronos height=60 src="../../reso
urces/KhronosGroup-3D.png" width=220></a> | |
16 </div> | |
17 </div> | |
18 <!--end-logo--> | |
19 | |
20 <h1>WebGL Extension Template</h1> | |
21 | |
22 <div class="nonnormative"> | |
23 <p> | |
24 Comments in this extension template are highlighted in green. This entir
e section is one big | |
25 comment. | |
26 </p> | |
27 <p> | |
28 This template for WebGL extensions is derived from | |
29 the <a href="http://www.opengl.org/registry/doc/template.txt">OpenGL ext
ension template</a>. | |
30 Refer to the OpenGL extension template for full documentation of the con
tent that should be | |
31 contained in the sections below. Because WebGL is fundamentally a Web AP
I, its extensions | |
32 are specified in HTML for easier hyperlinking. | |
33 </p> | |
34 <p> | |
35 Because most WebGL extensions are expected to simply mirror existing Ope
nGL and OpenGL ES | |
36 extensions, it is desirable to keep the WebGL extension specifications a
s small as possible | |
37 and simply refer to the other specifications for the behavioral definiti
ons. | |
38 </p> | |
39 </div> | |
40 | |
41 <h2 class="no-toc">Name</h2> | |
42 <div class="nonnormative"> | |
43 <p> | |
44 The name of the extension. This is also the string which is passed to | |
45 the <code>WebGLRenderingContext</code> <code>getExtension</code> API to en
able the | |
46 extension. For example, if the extension name were <code>OES_texture_float
</code>, then the | |
47 extension would be fetched and enabled with a call | |
48 to <code>getExtension("OES_texture_float")</code>. | |
49 </p> | |
50 <p> | |
51 Per WebGL convention, the <code>GL_</code> prefix is dropped from all exte
nsion and enum names, and the | |
52 <code>gl</code> prefix dropped from, and capitalization adjusted of, all f
unction names. | |
53 </p> | |
54 </div> | |
55 | |
56 <h2 class="no-toc">Contact</h2> | |
57 | |
58 <div class="nonnormative"> | |
59 <p> The email address of the contact of the specification. Prefer to use '
at' instead of | |
60 the <code>@</code> character to reduce spam. </p> | |
61 </div> | |
62 | |
63 <h2 class="no-toc">Contributors</h2> | |
64 | |
65 <div class="nonnormative"> | |
66 <p> Names and email addresses of individuals who contributed to the develo
pment of the | |
67 specification. </p> | |
68 </div> | |
69 | |
70 <h2 class="no-toc">Version</h2> | |
71 | |
72 <div class="nonnormative"> | |
73 <p> Last modified date and revision number of this specification. Example:
</p> | |
74 <p> | |
75 Last modified date: November 29, 2010 <br> | |
76 Revision: 1 | |
77 </p> | |
78 </div> | |
79 | |
80 <h2 class="no-toc">Number</h2> | |
81 | |
82 <div class="nonnormative"> | |
83 The number of the extension in the <a href="../">WebGL extension registry<
/a>. | |
84 </div> | |
85 | |
86 <h2 class="no-toc">Dependencies</h2> | |
87 | |
88 <div class="nonnormative"> | |
89 <p> | |
90 The WebGL specification version against which this extension is written. F
or example: | |
91 </p> | |
92 <p> | |
93 Written against the WebGL API 1.0 specification. | |
94 </p> | |
95 </div> | |
96 | |
97 <h2 class="no-toc">Overview</h2> | |
98 | |
99 <div class="nonnormative"> | |
100 <p> | |
101 A description of what this extension actually does. If this extension simp
ly mirrors an OpenGL | |
102 or OpenGL ES extension, it is recommended to simply link to that other ext
ension's | |
103 specification. For example: | |
104 </p> | |
105 <p> | |
106 This extension exposes the | |
107 <a href="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_f
loat.txt">OES_texture_float</a> | |
108 functionality to WebGL. There are no WebGL-specific behavioral changes. C
onsult the above | |
109 extension for all documentation, issues, and new functions and enumerants. | |
110 </p> | |
111 </div> | |
112 | |
113 <h2 class="no-toc">IDL</h2> | |
114 | |
115 <div class="nonnormative"> | |
116 <p> | |
117 This section should contain the inline Web IDL for the extension, surround
ed by the | |
118 tags <code><pre class="idl">...</pre></code>. Enums and functi
ons introduced by | |
119 the extension should be specified as <code>const GLenum</code> and methods
on the extension | |
120 object. The extension IDL should be written assuming that the typedefs | |
121 in <code><a href="../../specs/latest/webgl.idl">webgl.idl</a></code> | |
122 and <code><a href="../../typedarray/specs/latest/typedarrays.idl">typedarr
ays.idl</a></code> | |
123 have already been defined, and may implicitly reference other web platform
specifications. | |
124 </p> | |
125 <p> | |
126 </p> | |
127 <p> | |
128 Example contents for a hypothetical extension: | |
129 </p> | |
130 <pre class="idl"> | |
131 module webgl { | |
132 | |
133 interface OES_foo_bar { | |
134 const GLenum NEW_ENUM = 0xF00; | |
135 | |
136 void doSomethingNew(GLenum state, GLuint value); | |
137 }; // interface OES_foo_bar | |
138 | |
139 }; // module webgl | |
140 </pre> | |
141 </div> | |
142 | |
143 <h2 class="no-toc">IP Status</h2> | |
144 <h2 class="no-toc">New Procedures and Functions</h2> | |
145 <h2 class="no-toc">New Types</h2> | |
146 <h2 class="no-toc">New Tokens</h2> | |
147 <h2 class="no-toc">Additions to Chapters of the OpenGL ES 2.0 Specification<
/h2> | |
148 <h2 class="no-toc">Dependencies on GL and ES profiles, versions, and other e
xtensions</h2> | |
149 <h2 class="no-toc">Errors</h2> | |
150 <h2 class="no-toc">New State</h2> | |
151 <h2 class="no-toc">New Implementation Dependent State</h2> | |
152 <h2 class="no-toc">Sample Code</h2> | |
153 <h2 class="no-toc">Conformance Tests</h2> | |
154 <h2 class="no-toc">Issues</h2> | |
155 | |
156 <div class="nonnormative"> | |
157 Refer to the <a href="http://www.opengl.org/registry/doc/template.txt">Ope
nGL extension | |
158 template</a> for a description of these sections. These sections should be
eliminated for | |
159 WebGL extensions simply mirroring OpenGL or OpenGL ES extensions. | |
160 </div> | |
161 | |
162 <h2 class="no-toc">Revision History</h2> | |
163 | |
164 <div class="nonnormative"> | |
165 <p> | |
166 Include important changes in the evolution of the extension. It's especial
ly important to | |
167 include this section if the extension is modified after a version has been
shipped. Consult | |
168 the <a href="http://www.opengl.org/registry/doc/template.txt">OpenGL exten
sion template</a> | |
169 for an example. | |
170 </p> | |
171 </div> | |
172 </body> | |
173 </html> | |
OLD | NEW |