Thu, 22 Jan 2015 13:21:57 +0100
Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6
1 /* -*- Mode: IDL; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /* This Source Code Form is subject to the terms of the Mozilla Public
3 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
4 * You can obtain one at http://mozilla.org/MPL/2.0/.
5 *
6 * The origin of this IDL file is
7 * https://www.khronos.org/registry/webgl/specs/latest/webgl.idl
8 *
9 * Copyright © 2012 Khronos Group
10 */
12 // WebGL IDL definitions scraped from the Khronos specification:
13 // https://www.khronos.org/registry/webgl/specs/latest/
14 //
15 // This IDL depends on the typed array specification defined at:
16 // https://www.khronos.org/registry/typedarray/specs/latest/typedarrays.idl
18 typedef unsigned long GLenum;
19 typedef boolean GLboolean;
20 typedef unsigned long GLbitfield;
21 typedef byte GLbyte; /* 'byte' should be a signed 8 bit type. */
22 typedef short GLshort;
23 typedef long GLint;
24 typedef long GLsizei;
25 typedef long long GLintptr;
26 typedef long long GLsizeiptr;
27 // Ideally the typedef below would use 'unsigned byte', but that doesn't currently exist in Web IDL.
28 typedef octet GLubyte; /* 'octet' should be an unsigned 8 bit type. */
29 typedef unsigned short GLushort;
30 typedef unsigned long GLuint;
31 typedef unrestricted float GLfloat;
32 typedef unrestricted float GLclampf;
34 dictionary WebGLContextAttributes {
35 // boolean alpha = true;
36 // We deviate from the spec here.
37 // If alpha isn't specified, we rely on a pref ("webgl.default-no-alpha")
38 boolean alpha;
39 boolean depth = true;
40 boolean stencil = false;
41 boolean antialias = true;
42 boolean premultipliedAlpha = true;
43 boolean preserveDrawingBuffer = false;
44 };
46 interface WebGLBuffer {
47 };
49 interface WebGLFramebuffer {
50 };
52 interface WebGLProgram {
53 };
55 interface WebGLRenderbuffer {
56 };
58 interface WebGLShader {
59 };
61 interface WebGLTexture {
62 };
64 interface WebGLUniformLocation {
65 };
67 interface WebGLVertexArray {
68 };
70 interface WebGLActiveInfo {
71 readonly attribute GLint size;
72 readonly attribute GLenum type;
73 readonly attribute DOMString name;
74 };
76 interface WebGLShaderPrecisionFormat {
77 readonly attribute GLint rangeMin;
78 readonly attribute GLint rangeMax;
79 readonly attribute GLint precision;
80 };
82 interface WebGLRenderingContext {
84 /* ClearBufferMask */
85 const GLenum DEPTH_BUFFER_BIT = 0x00000100;
86 const GLenum STENCIL_BUFFER_BIT = 0x00000400;
87 const GLenum COLOR_BUFFER_BIT = 0x00004000;
89 /* BeginMode */
90 const GLenum POINTS = 0x0000;
91 const GLenum LINES = 0x0001;
92 const GLenum LINE_LOOP = 0x0002;
93 const GLenum LINE_STRIP = 0x0003;
94 const GLenum TRIANGLES = 0x0004;
95 const GLenum TRIANGLE_STRIP = 0x0005;
96 const GLenum TRIANGLE_FAN = 0x0006;
98 /* AlphaFunction (not supported in ES20) */
99 /* NEVER */
100 /* LESS */
101 /* EQUAL */
102 /* LEQUAL */
103 /* GREATER */
104 /* NOTEQUAL */
105 /* GEQUAL */
106 /* ALWAYS */
108 /* BlendingFactorDest */
109 const GLenum ZERO = 0;
110 const GLenum ONE = 1;
111 const GLenum SRC_COLOR = 0x0300;
112 const GLenum ONE_MINUS_SRC_COLOR = 0x0301;
113 const GLenum SRC_ALPHA = 0x0302;
114 const GLenum ONE_MINUS_SRC_ALPHA = 0x0303;
115 const GLenum DST_ALPHA = 0x0304;
116 const GLenum ONE_MINUS_DST_ALPHA = 0x0305;
118 /* BlendingFactorSrc */
119 /* ZERO */
120 /* ONE */
121 const GLenum DST_COLOR = 0x0306;
122 const GLenum ONE_MINUS_DST_COLOR = 0x0307;
123 const GLenum SRC_ALPHA_SATURATE = 0x0308;
124 /* SRC_ALPHA */
125 /* ONE_MINUS_SRC_ALPHA */
126 /* DST_ALPHA */
127 /* ONE_MINUS_DST_ALPHA */
129 /* BlendEquationSeparate */
130 const GLenum FUNC_ADD = 0x8006;
131 const GLenum BLEND_EQUATION = 0x8009;
132 const GLenum BLEND_EQUATION_RGB = 0x8009; /* same as BLEND_EQUATION */
133 const GLenum BLEND_EQUATION_ALPHA = 0x883D;
135 /* BlendSubtract */
136 const GLenum FUNC_SUBTRACT = 0x800A;
137 const GLenum FUNC_REVERSE_SUBTRACT = 0x800B;
139 /* Separate Blend Functions */
140 const GLenum BLEND_DST_RGB = 0x80C8;
141 const GLenum BLEND_SRC_RGB = 0x80C9;
142 const GLenum BLEND_DST_ALPHA = 0x80CA;
143 const GLenum BLEND_SRC_ALPHA = 0x80CB;
144 const GLenum CONSTANT_COLOR = 0x8001;
145 const GLenum ONE_MINUS_CONSTANT_COLOR = 0x8002;
146 const GLenum CONSTANT_ALPHA = 0x8003;
147 const GLenum ONE_MINUS_CONSTANT_ALPHA = 0x8004;
148 const GLenum BLEND_COLOR = 0x8005;
150 /* Buffer Objects */
151 const GLenum ARRAY_BUFFER = 0x8892;
152 const GLenum ELEMENT_ARRAY_BUFFER = 0x8893;
153 const GLenum ARRAY_BUFFER_BINDING = 0x8894;
154 const GLenum ELEMENT_ARRAY_BUFFER_BINDING = 0x8895;
156 const GLenum STREAM_DRAW = 0x88E0;
157 const GLenum STATIC_DRAW = 0x88E4;
158 const GLenum DYNAMIC_DRAW = 0x88E8;
160 const GLenum BUFFER_SIZE = 0x8764;
161 const GLenum BUFFER_USAGE = 0x8765;
163 const GLenum CURRENT_VERTEX_ATTRIB = 0x8626;
165 /* CullFaceMode */
166 const GLenum FRONT = 0x0404;
167 const GLenum BACK = 0x0405;
168 const GLenum FRONT_AND_BACK = 0x0408;
170 /* DepthFunction */
171 /* NEVER */
172 /* LESS */
173 /* EQUAL */
174 /* LEQUAL */
175 /* GREATER */
176 /* NOTEQUAL */
177 /* GEQUAL */
178 /* ALWAYS */
180 /* EnableCap */
181 /* TEXTURE_2D */
182 const GLenum CULL_FACE = 0x0B44;
183 const GLenum BLEND = 0x0BE2;
184 const GLenum DITHER = 0x0BD0;
185 const GLenum STENCIL_TEST = 0x0B90;
186 const GLenum DEPTH_TEST = 0x0B71;
187 const GLenum SCISSOR_TEST = 0x0C11;
188 const GLenum POLYGON_OFFSET_FILL = 0x8037;
189 const GLenum SAMPLE_ALPHA_TO_COVERAGE = 0x809E;
190 const GLenum SAMPLE_COVERAGE = 0x80A0;
192 /* ErrorCode */
193 const GLenum NO_ERROR = 0;
194 const GLenum INVALID_ENUM = 0x0500;
195 const GLenum INVALID_VALUE = 0x0501;
196 const GLenum INVALID_OPERATION = 0x0502;
197 const GLenum OUT_OF_MEMORY = 0x0505;
199 /* FrontFaceDirection */
200 const GLenum CW = 0x0900;
201 const GLenum CCW = 0x0901;
203 /* GetPName */
204 const GLenum LINE_WIDTH = 0x0B21;
205 const GLenum ALIASED_POINT_SIZE_RANGE = 0x846D;
206 const GLenum ALIASED_LINE_WIDTH_RANGE = 0x846E;
207 const GLenum CULL_FACE_MODE = 0x0B45;
208 const GLenum FRONT_FACE = 0x0B46;
209 const GLenum DEPTH_RANGE = 0x0B70;
210 const GLenum DEPTH_WRITEMASK = 0x0B72;
211 const GLenum DEPTH_CLEAR_VALUE = 0x0B73;
212 const GLenum DEPTH_FUNC = 0x0B74;
213 const GLenum STENCIL_CLEAR_VALUE = 0x0B91;
214 const GLenum STENCIL_FUNC = 0x0B92;
215 const GLenum STENCIL_FAIL = 0x0B94;
216 const GLenum STENCIL_PASS_DEPTH_FAIL = 0x0B95;
217 const GLenum STENCIL_PASS_DEPTH_PASS = 0x0B96;
218 const GLenum STENCIL_REF = 0x0B97;
219 const GLenum STENCIL_VALUE_MASK = 0x0B93;
220 const GLenum STENCIL_WRITEMASK = 0x0B98;
221 const GLenum STENCIL_BACK_FUNC = 0x8800;
222 const GLenum STENCIL_BACK_FAIL = 0x8801;
223 const GLenum STENCIL_BACK_PASS_DEPTH_FAIL = 0x8802;
224 const GLenum STENCIL_BACK_PASS_DEPTH_PASS = 0x8803;
225 const GLenum STENCIL_BACK_REF = 0x8CA3;
226 const GLenum STENCIL_BACK_VALUE_MASK = 0x8CA4;
227 const GLenum STENCIL_BACK_WRITEMASK = 0x8CA5;
228 const GLenum VIEWPORT = 0x0BA2;
229 const GLenum SCISSOR_BOX = 0x0C10;
230 /* SCISSOR_TEST */
231 const GLenum COLOR_CLEAR_VALUE = 0x0C22;
232 const GLenum COLOR_WRITEMASK = 0x0C23;
233 const GLenum UNPACK_ALIGNMENT = 0x0CF5;
234 const GLenum PACK_ALIGNMENT = 0x0D05;
235 const GLenum MAX_TEXTURE_SIZE = 0x0D33;
236 const GLenum MAX_VIEWPORT_DIMS = 0x0D3A;
237 const GLenum SUBPIXEL_BITS = 0x0D50;
238 const GLenum RED_BITS = 0x0D52;
239 const GLenum GREEN_BITS = 0x0D53;
240 const GLenum BLUE_BITS = 0x0D54;
241 const GLenum ALPHA_BITS = 0x0D55;
242 const GLenum DEPTH_BITS = 0x0D56;
243 const GLenum STENCIL_BITS = 0x0D57;
244 const GLenum POLYGON_OFFSET_UNITS = 0x2A00;
245 /* POLYGON_OFFSET_FILL */
246 const GLenum POLYGON_OFFSET_FACTOR = 0x8038;
247 const GLenum TEXTURE_BINDING_2D = 0x8069;
248 const GLenum SAMPLE_BUFFERS = 0x80A8;
249 const GLenum SAMPLES = 0x80A9;
250 const GLenum SAMPLE_COVERAGE_VALUE = 0x80AA;
251 const GLenum SAMPLE_COVERAGE_INVERT = 0x80AB;
253 /* GetTextureParameter */
254 /* TEXTURE_MAG_FILTER */
255 /* TEXTURE_MIN_FILTER */
256 /* TEXTURE_WRAP_S */
257 /* TEXTURE_WRAP_T */
259 const GLenum COMPRESSED_TEXTURE_FORMATS = 0x86A3;
261 /* HintMode */
262 const GLenum DONT_CARE = 0x1100;
263 const GLenum FASTEST = 0x1101;
264 const GLenum NICEST = 0x1102;
266 /* HintTarget */
267 const GLenum GENERATE_MIPMAP_HINT = 0x8192;
269 /* DataType */
270 const GLenum BYTE = 0x1400;
271 const GLenum UNSIGNED_BYTE = 0x1401;
272 const GLenum SHORT = 0x1402;
273 const GLenum UNSIGNED_SHORT = 0x1403;
274 const GLenum INT = 0x1404;
275 const GLenum UNSIGNED_INT = 0x1405;
276 const GLenum FLOAT = 0x1406;
278 /* PixelFormat */
279 const GLenum DEPTH_COMPONENT = 0x1902;
280 const GLenum ALPHA = 0x1906;
281 const GLenum RGB = 0x1907;
282 const GLenum RGBA = 0x1908;
283 const GLenum LUMINANCE = 0x1909;
284 const GLenum LUMINANCE_ALPHA = 0x190A;
286 /* PixelType */
287 /* UNSIGNED_BYTE */
288 const GLenum UNSIGNED_SHORT_4_4_4_4 = 0x8033;
289 const GLenum UNSIGNED_SHORT_5_5_5_1 = 0x8034;
290 const GLenum UNSIGNED_SHORT_5_6_5 = 0x8363;
292 /* Shaders */
293 const GLenum FRAGMENT_SHADER = 0x8B30;
294 const GLenum VERTEX_SHADER = 0x8B31;
295 const GLenum MAX_VERTEX_ATTRIBS = 0x8869;
296 const GLenum MAX_VERTEX_UNIFORM_VECTORS = 0x8DFB;
297 const GLenum MAX_VARYING_VECTORS = 0x8DFC;
298 const GLenum MAX_COMBINED_TEXTURE_IMAGE_UNITS = 0x8B4D;
299 const GLenum MAX_VERTEX_TEXTURE_IMAGE_UNITS = 0x8B4C;
300 const GLenum MAX_TEXTURE_IMAGE_UNITS = 0x8872;
301 const GLenum MAX_FRAGMENT_UNIFORM_VECTORS = 0x8DFD;
302 const GLenum SHADER_TYPE = 0x8B4F;
303 const GLenum DELETE_STATUS = 0x8B80;
304 const GLenum LINK_STATUS = 0x8B82;
305 const GLenum VALIDATE_STATUS = 0x8B83;
306 const GLenum ATTACHED_SHADERS = 0x8B85;
307 const GLenum ACTIVE_UNIFORMS = 0x8B86;
308 const GLenum ACTIVE_ATTRIBUTES = 0x8B89;
309 const GLenum SHADING_LANGUAGE_VERSION = 0x8B8C;
310 const GLenum CURRENT_PROGRAM = 0x8B8D;
312 /* StencilFunction */
313 const GLenum NEVER = 0x0200;
314 const GLenum LESS = 0x0201;
315 const GLenum EQUAL = 0x0202;
316 const GLenum LEQUAL = 0x0203;
317 const GLenum GREATER = 0x0204;
318 const GLenum NOTEQUAL = 0x0205;
319 const GLenum GEQUAL = 0x0206;
320 const GLenum ALWAYS = 0x0207;
322 /* StencilOp */
323 /* ZERO */
324 const GLenum KEEP = 0x1E00;
325 const GLenum REPLACE = 0x1E01;
326 const GLenum INCR = 0x1E02;
327 const GLenum DECR = 0x1E03;
328 const GLenum INVERT = 0x150A;
329 const GLenum INCR_WRAP = 0x8507;
330 const GLenum DECR_WRAP = 0x8508;
332 /* StringName */
333 const GLenum VENDOR = 0x1F00;
334 const GLenum RENDERER = 0x1F01;
335 const GLenum VERSION = 0x1F02;
337 /* TextureMagFilter */
338 const GLenum NEAREST = 0x2600;
339 const GLenum LINEAR = 0x2601;
341 /* TextureMinFilter */
342 /* NEAREST */
343 /* LINEAR */
344 const GLenum NEAREST_MIPMAP_NEAREST = 0x2700;
345 const GLenum LINEAR_MIPMAP_NEAREST = 0x2701;
346 const GLenum NEAREST_MIPMAP_LINEAR = 0x2702;
347 const GLenum LINEAR_MIPMAP_LINEAR = 0x2703;
349 /* TextureParameterName */
350 const GLenum TEXTURE_MAG_FILTER = 0x2800;
351 const GLenum TEXTURE_MIN_FILTER = 0x2801;
352 const GLenum TEXTURE_WRAP_S = 0x2802;
353 const GLenum TEXTURE_WRAP_T = 0x2803;
355 /* TextureTarget */
356 const GLenum TEXTURE_2D = 0x0DE1;
357 const GLenum TEXTURE = 0x1702;
359 const GLenum TEXTURE_CUBE_MAP = 0x8513;
360 const GLenum TEXTURE_BINDING_CUBE_MAP = 0x8514;
361 const GLenum TEXTURE_CUBE_MAP_POSITIVE_X = 0x8515;
362 const GLenum TEXTURE_CUBE_MAP_NEGATIVE_X = 0x8516;
363 const GLenum TEXTURE_CUBE_MAP_POSITIVE_Y = 0x8517;
364 const GLenum TEXTURE_CUBE_MAP_NEGATIVE_Y = 0x8518;
365 const GLenum TEXTURE_CUBE_MAP_POSITIVE_Z = 0x8519;
366 const GLenum TEXTURE_CUBE_MAP_NEGATIVE_Z = 0x851A;
367 const GLenum MAX_CUBE_MAP_TEXTURE_SIZE = 0x851C;
369 /* TextureUnit */
370 const GLenum TEXTURE0 = 0x84C0;
371 const GLenum TEXTURE1 = 0x84C1;
372 const GLenum TEXTURE2 = 0x84C2;
373 const GLenum TEXTURE3 = 0x84C3;
374 const GLenum TEXTURE4 = 0x84C4;
375 const GLenum TEXTURE5 = 0x84C5;
376 const GLenum TEXTURE6 = 0x84C6;
377 const GLenum TEXTURE7 = 0x84C7;
378 const GLenum TEXTURE8 = 0x84C8;
379 const GLenum TEXTURE9 = 0x84C9;
380 const GLenum TEXTURE10 = 0x84CA;
381 const GLenum TEXTURE11 = 0x84CB;
382 const GLenum TEXTURE12 = 0x84CC;
383 const GLenum TEXTURE13 = 0x84CD;
384 const GLenum TEXTURE14 = 0x84CE;
385 const GLenum TEXTURE15 = 0x84CF;
386 const GLenum TEXTURE16 = 0x84D0;
387 const GLenum TEXTURE17 = 0x84D1;
388 const GLenum TEXTURE18 = 0x84D2;
389 const GLenum TEXTURE19 = 0x84D3;
390 const GLenum TEXTURE20 = 0x84D4;
391 const GLenum TEXTURE21 = 0x84D5;
392 const GLenum TEXTURE22 = 0x84D6;
393 const GLenum TEXTURE23 = 0x84D7;
394 const GLenum TEXTURE24 = 0x84D8;
395 const GLenum TEXTURE25 = 0x84D9;
396 const GLenum TEXTURE26 = 0x84DA;
397 const GLenum TEXTURE27 = 0x84DB;
398 const GLenum TEXTURE28 = 0x84DC;
399 const GLenum TEXTURE29 = 0x84DD;
400 const GLenum TEXTURE30 = 0x84DE;
401 const GLenum TEXTURE31 = 0x84DF;
402 const GLenum ACTIVE_TEXTURE = 0x84E0;
404 /* TextureWrapMode */
405 const GLenum REPEAT = 0x2901;
406 const GLenum CLAMP_TO_EDGE = 0x812F;
407 const GLenum MIRRORED_REPEAT = 0x8370;
409 /* Uniform Types */
410 const GLenum FLOAT_VEC2 = 0x8B50;
411 const GLenum FLOAT_VEC3 = 0x8B51;
412 const GLenum FLOAT_VEC4 = 0x8B52;
413 const GLenum INT_VEC2 = 0x8B53;
414 const GLenum INT_VEC3 = 0x8B54;
415 const GLenum INT_VEC4 = 0x8B55;
416 const GLenum BOOL = 0x8B56;
417 const GLenum BOOL_VEC2 = 0x8B57;
418 const GLenum BOOL_VEC3 = 0x8B58;
419 const GLenum BOOL_VEC4 = 0x8B59;
420 const GLenum FLOAT_MAT2 = 0x8B5A;
421 const GLenum FLOAT_MAT3 = 0x8B5B;
422 const GLenum FLOAT_MAT4 = 0x8B5C;
423 const GLenum SAMPLER_2D = 0x8B5E;
424 const GLenum SAMPLER_CUBE = 0x8B60;
426 /* Vertex Arrays */
427 const GLenum VERTEX_ATTRIB_ARRAY_ENABLED = 0x8622;
428 const GLenum VERTEX_ATTRIB_ARRAY_SIZE = 0x8623;
429 const GLenum VERTEX_ATTRIB_ARRAY_STRIDE = 0x8624;
430 const GLenum VERTEX_ATTRIB_ARRAY_TYPE = 0x8625;
431 const GLenum VERTEX_ATTRIB_ARRAY_NORMALIZED = 0x886A;
432 const GLenum VERTEX_ATTRIB_ARRAY_POINTER = 0x8645;
433 const GLenum VERTEX_ATTRIB_ARRAY_BUFFER_BINDING = 0x889F;
435 /* Shader Source */
436 const GLenum COMPILE_STATUS = 0x8B81;
438 /* Shader Precision-Specified Types */
439 const GLenum LOW_FLOAT = 0x8DF0;
440 const GLenum MEDIUM_FLOAT = 0x8DF1;
441 const GLenum HIGH_FLOAT = 0x8DF2;
442 const GLenum LOW_INT = 0x8DF3;
443 const GLenum MEDIUM_INT = 0x8DF4;
444 const GLenum HIGH_INT = 0x8DF5;
446 /* Framebuffer Object. */
447 const GLenum FRAMEBUFFER = 0x8D40;
448 const GLenum RENDERBUFFER = 0x8D41;
450 const GLenum RGBA4 = 0x8056;
451 const GLenum RGB5_A1 = 0x8057;
452 const GLenum RGB565 = 0x8D62;
453 const GLenum DEPTH_COMPONENT16 = 0x81A5;
454 const GLenum STENCIL_INDEX = 0x1901;
455 const GLenum STENCIL_INDEX8 = 0x8D48;
456 const GLenum DEPTH_STENCIL = 0x84F9;
458 const GLenum RENDERBUFFER_WIDTH = 0x8D42;
459 const GLenum RENDERBUFFER_HEIGHT = 0x8D43;
460 const GLenum RENDERBUFFER_INTERNAL_FORMAT = 0x8D44;
461 const GLenum RENDERBUFFER_RED_SIZE = 0x8D50;
462 const GLenum RENDERBUFFER_GREEN_SIZE = 0x8D51;
463 const GLenum RENDERBUFFER_BLUE_SIZE = 0x8D52;
464 const GLenum RENDERBUFFER_ALPHA_SIZE = 0x8D53;
465 const GLenum RENDERBUFFER_DEPTH_SIZE = 0x8D54;
466 const GLenum RENDERBUFFER_STENCIL_SIZE = 0x8D55;
468 const GLenum FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE = 0x8CD0;
469 const GLenum FRAMEBUFFER_ATTACHMENT_OBJECT_NAME = 0x8CD1;
470 const GLenum FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL = 0x8CD2;
471 const GLenum FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE = 0x8CD3;
473 const GLenum COLOR_ATTACHMENT0 = 0x8CE0;
474 const GLenum DEPTH_ATTACHMENT = 0x8D00;
475 const GLenum STENCIL_ATTACHMENT = 0x8D20;
476 const GLenum DEPTH_STENCIL_ATTACHMENT = 0x821A;
478 const GLenum NONE = 0;
480 const GLenum FRAMEBUFFER_COMPLETE = 0x8CD5;
481 const GLenum FRAMEBUFFER_INCOMPLETE_ATTACHMENT = 0x8CD6;
482 const GLenum FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT = 0x8CD7;
483 const GLenum FRAMEBUFFER_INCOMPLETE_DIMENSIONS = 0x8CD9;
484 const GLenum FRAMEBUFFER_UNSUPPORTED = 0x8CDD;
486 const GLenum FRAMEBUFFER_BINDING = 0x8CA6;
487 const GLenum RENDERBUFFER_BINDING = 0x8CA7;
488 const GLenum MAX_RENDERBUFFER_SIZE = 0x84E8;
490 const GLenum INVALID_FRAMEBUFFER_OPERATION = 0x0506;
492 /* WebGL-specific enums */
493 const GLenum UNPACK_FLIP_Y_WEBGL = 0x9240;
494 const GLenum UNPACK_PREMULTIPLY_ALPHA_WEBGL = 0x9241;
495 const GLenum CONTEXT_LOST_WEBGL = 0x9242;
496 const GLenum UNPACK_COLORSPACE_CONVERSION_WEBGL = 0x9243;
497 const GLenum BROWSER_DEFAULT_WEBGL = 0x9244;
499 // The canvas might actually be null in some cases, apparently.
500 readonly attribute HTMLCanvasElement? canvas;
501 readonly attribute GLsizei drawingBufferWidth;
502 readonly attribute GLsizei drawingBufferHeight;
504 [WebGLHandlesContextLoss] WebGLContextAttributes? getContextAttributes();
505 [WebGLHandlesContextLoss] boolean isContextLost();
507 sequence<DOMString>? getSupportedExtensions();
509 [Throws]
510 object? getExtension(DOMString name);
512 void activeTexture(GLenum texture);
513 void attachShader(WebGLProgram? program, WebGLShader? shader);
514 void bindAttribLocation(WebGLProgram? program, GLuint index, DOMString name);
515 void bindBuffer(GLenum target, WebGLBuffer? buffer);
516 void bindFramebuffer(GLenum target, WebGLFramebuffer? framebuffer);
517 void bindRenderbuffer(GLenum target, WebGLRenderbuffer? renderbuffer);
518 void bindTexture(GLenum target, WebGLTexture? texture);
519 void blendColor(GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha);
520 void blendEquation(GLenum mode);
521 void blendEquationSeparate(GLenum modeRGB, GLenum modeAlpha);
522 void blendFunc(GLenum sfactor, GLenum dfactor);
523 void blendFuncSeparate(GLenum srcRGB, GLenum dstRGB,
524 GLenum srcAlpha, GLenum dstAlpha);
526 void bufferData(GLenum target, GLsizeiptr size, GLenum usage);
527 void bufferData(GLenum target, ArrayBufferView data, GLenum usage);
528 void bufferData(GLenum target, ArrayBuffer? data, GLenum usage);
529 void bufferSubData(GLenum target, GLintptr offset, ArrayBufferView data);
530 void bufferSubData(GLenum target, GLintptr offset, ArrayBuffer? data);
532 [WebGLHandlesContextLoss] GLenum checkFramebufferStatus(GLenum target);
533 void clear(GLbitfield mask);
534 void clearColor(GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha);
535 void clearDepth(GLclampf depth);
536 void clearStencil(GLint s);
537 void colorMask(GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha);
538 void compileShader(WebGLShader? shader);
540 void compressedTexImage2D(GLenum target, GLint level, GLenum internalformat,
541 GLsizei width, GLsizei height, GLint border,
542 ArrayBufferView data);
543 void compressedTexSubImage2D(GLenum target, GLint level,
544 GLint xoffset, GLint yoffset,
545 GLsizei width, GLsizei height, GLenum format,
546 ArrayBufferView data);
548 void copyTexImage2D(GLenum target, GLint level, GLenum internalformat,
549 GLint x, GLint y, GLsizei width, GLsizei height,
550 GLint border);
551 void copyTexSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
552 GLint x, GLint y, GLsizei width, GLsizei height);
554 WebGLBuffer? createBuffer();
555 WebGLFramebuffer? createFramebuffer();
556 WebGLProgram? createProgram();
557 WebGLRenderbuffer? createRenderbuffer();
558 WebGLShader? createShader(GLenum type);
559 WebGLTexture? createTexture();
561 void cullFace(GLenum mode);
563 void deleteBuffer(WebGLBuffer? buffer);
564 void deleteFramebuffer(WebGLFramebuffer? framebuffer);
565 void deleteProgram(WebGLProgram? program);
566 void deleteRenderbuffer(WebGLRenderbuffer? renderbuffer);
567 void deleteShader(WebGLShader? shader);
568 void deleteTexture(WebGLTexture? texture);
570 void depthFunc(GLenum func);
571 void depthMask(GLboolean flag);
572 void depthRange(GLclampf zNear, GLclampf zFar);
573 void detachShader(WebGLProgram? program, WebGLShader? shader);
574 void disable(GLenum cap);
575 void disableVertexAttribArray(GLuint index);
576 void drawArrays(GLenum mode, GLint first, GLsizei count);
577 void drawElements(GLenum mode, GLsizei count, GLenum type, GLintptr offset);
579 void enable(GLenum cap);
580 void enableVertexAttribArray(GLuint index);
581 void finish();
582 void flush();
583 void framebufferRenderbuffer(GLenum target, GLenum attachment,
584 GLenum renderbuffertarget,
585 WebGLRenderbuffer? renderbuffer);
586 void framebufferTexture2D(GLenum target, GLenum attachment, GLenum textarget,
587 WebGLTexture? texture, GLint level);
588 void frontFace(GLenum mode);
590 void generateMipmap(GLenum target);
592 [NewObject]
593 WebGLActiveInfo? getActiveAttrib(WebGLProgram? program, GLuint index);
594 [NewObject]
595 WebGLActiveInfo? getActiveUniform(WebGLProgram? program, GLuint index);
597 sequence<WebGLShader>? getAttachedShaders(WebGLProgram? program);
599 [WebGLHandlesContextLoss] GLint getAttribLocation(WebGLProgram? program, DOMString name);
601 any getBufferParameter(GLenum target, GLenum pname);
602 [Throws]
603 any getParameter(GLenum pname);
605 [WebGLHandlesContextLoss] GLenum getError();
607 [Throws]
608 any getFramebufferAttachmentParameter(GLenum target, GLenum attachment,
609 GLenum pname);
610 any getProgramParameter(WebGLProgram? program, GLenum pname);
611 DOMString? getProgramInfoLog(WebGLProgram? program);
612 any getRenderbufferParameter(GLenum target, GLenum pname);
613 any getShaderParameter(WebGLShader? shader, GLenum pname);
615 [NewObject]
616 WebGLShaderPrecisionFormat? getShaderPrecisionFormat(GLenum shadertype, GLenum precisiontype);
618 DOMString? getShaderInfoLog(WebGLShader? shader);
620 DOMString? getShaderSource(WebGLShader? shader);
622 any getTexParameter(GLenum target, GLenum pname);
624 any getUniform(WebGLProgram? program, WebGLUniformLocation? location);
626 [NewObject]
627 WebGLUniformLocation? getUniformLocation(WebGLProgram? program, DOMString name);
629 [Throws]
630 any getVertexAttrib(GLuint index, GLenum pname);
632 [WebGLHandlesContextLoss] GLsizeiptr getVertexAttribOffset(GLuint index, GLenum pname);
634 void hint(GLenum target, GLenum mode);
635 [WebGLHandlesContextLoss] GLboolean isBuffer(WebGLBuffer? buffer);
636 [WebGLHandlesContextLoss] GLboolean isEnabled(GLenum cap);
637 [WebGLHandlesContextLoss] GLboolean isFramebuffer(WebGLFramebuffer? framebuffer);
638 [WebGLHandlesContextLoss] GLboolean isProgram(WebGLProgram? program);
639 [WebGLHandlesContextLoss] GLboolean isRenderbuffer(WebGLRenderbuffer? renderbuffer);
640 [WebGLHandlesContextLoss] GLboolean isShader(WebGLShader? shader);
641 [WebGLHandlesContextLoss] GLboolean isTexture(WebGLTexture? texture);
642 void lineWidth(GLfloat width);
643 void linkProgram(WebGLProgram? program);
644 void pixelStorei(GLenum pname, GLint param);
645 void polygonOffset(GLfloat factor, GLfloat units);
647 [Throws]
648 void readPixels(GLint x, GLint y, GLsizei width, GLsizei height,
649 GLenum format, GLenum type, ArrayBufferView? pixels);
651 void renderbufferStorage(GLenum target, GLenum internalformat,
652 GLsizei width, GLsizei height);
653 void sampleCoverage(GLclampf value, GLboolean invert);
654 void scissor(GLint x, GLint y, GLsizei width, GLsizei height);
656 void shaderSource(WebGLShader? shader, DOMString source);
658 void stencilFunc(GLenum func, GLint ref, GLuint mask);
659 void stencilFuncSeparate(GLenum face, GLenum func, GLint ref, GLuint mask);
660 void stencilMask(GLuint mask);
661 void stencilMaskSeparate(GLenum face, GLuint mask);
662 void stencilOp(GLenum fail, GLenum zfail, GLenum zpass);
663 void stencilOpSeparate(GLenum face, GLenum fail, GLenum zfail, GLenum zpass);
666 [Throws]
667 void texImage2D(GLenum target, GLint level, GLenum internalformat,
668 GLsizei width, GLsizei height, GLint border, GLenum format,
669 GLenum type, ArrayBufferView? pixels);
670 [Throws]
671 void texImage2D(GLenum target, GLint level, GLenum internalformat,
672 GLenum format, GLenum type, ImageData? pixels);
673 [Throws]
674 void texImage2D(GLenum target, GLint level, GLenum internalformat,
675 GLenum format, GLenum type, HTMLImageElement image); // May throw DOMException
676 [Throws]
677 void texImage2D(GLenum target, GLint level, GLenum internalformat,
678 GLenum format, GLenum type, HTMLCanvasElement canvas); // May throw DOMException
679 [Throws]
680 void texImage2D(GLenum target, GLint level, GLenum internalformat,
681 GLenum format, GLenum type, HTMLVideoElement video); // May throw DOMException
683 void texParameterf(GLenum target, GLenum pname, GLfloat param);
684 void texParameteri(GLenum target, GLenum pname, GLint param);
686 [Throws]
687 void texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
688 GLsizei width, GLsizei height,
689 GLenum format, GLenum type, ArrayBufferView? pixels);
690 [Throws]
691 void texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
692 GLenum format, GLenum type, ImageData? pixels);
693 [Throws]
694 void texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
695 GLenum format, GLenum type, HTMLImageElement image); // May throw DOMException
696 [Throws]
697 void texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
698 GLenum format, GLenum type, HTMLCanvasElement canvas); // May throw DOMException
699 [Throws]
700 void texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
701 GLenum format, GLenum type, HTMLVideoElement video); // May throw DOMException
703 void uniform1f(WebGLUniformLocation? location, GLfloat x);
704 void uniform1fv(WebGLUniformLocation? location, Float32Array v);
705 void uniform1fv(WebGLUniformLocation? location, sequence<GLfloat> v);
706 void uniform1i(WebGLUniformLocation? location, GLint x);
707 void uniform1iv(WebGLUniformLocation? location, Int32Array v);
708 void uniform1iv(WebGLUniformLocation? location, sequence<long> v);
709 void uniform2f(WebGLUniformLocation? location, GLfloat x, GLfloat y);
710 void uniform2fv(WebGLUniformLocation? location, Float32Array v);
711 void uniform2fv(WebGLUniformLocation? location, sequence<GLfloat> v);
712 void uniform2i(WebGLUniformLocation? location, GLint x, GLint y);
713 void uniform2iv(WebGLUniformLocation? location, Int32Array v);
714 void uniform2iv(WebGLUniformLocation? location, sequence<long> v);
715 void uniform3f(WebGLUniformLocation? location, GLfloat x, GLfloat y, GLfloat z);
716 void uniform3fv(WebGLUniformLocation? location, Float32Array v);
717 void uniform3fv(WebGLUniformLocation? location, sequence<GLfloat> v);
718 void uniform3i(WebGLUniformLocation? location, GLint x, GLint y, GLint z);
719 void uniform3iv(WebGLUniformLocation? location, Int32Array v);
720 void uniform3iv(WebGLUniformLocation? location, sequence<long> v);
721 void uniform4f(WebGLUniformLocation? location, GLfloat x, GLfloat y, GLfloat z, GLfloat w);
722 void uniform4fv(WebGLUniformLocation? location, Float32Array v);
723 void uniform4fv(WebGLUniformLocation? location, sequence<GLfloat> v);
724 void uniform4i(WebGLUniformLocation? location, GLint x, GLint y, GLint z, GLint w);
725 void uniform4iv(WebGLUniformLocation? location, Int32Array v);
726 void uniform4iv(WebGLUniformLocation? location, sequence<long> v);
728 void uniformMatrix2fv(WebGLUniformLocation? location, GLboolean transpose,
729 Float32Array value);
730 void uniformMatrix2fv(WebGLUniformLocation? location, GLboolean transpose,
731 sequence<GLfloat> value);
732 void uniformMatrix3fv(WebGLUniformLocation? location, GLboolean transpose,
733 Float32Array value);
734 void uniformMatrix3fv(WebGLUniformLocation? location, GLboolean transpose,
735 sequence<GLfloat> value);
736 void uniformMatrix4fv(WebGLUniformLocation? location, GLboolean transpose,
737 Float32Array value);
738 void uniformMatrix4fv(WebGLUniformLocation? location, GLboolean transpose,
739 sequence<GLfloat> value);
741 void useProgram(WebGLProgram? program);
742 void validateProgram(WebGLProgram? program);
744 void vertexAttrib1f(GLuint indx, GLfloat x);
745 void vertexAttrib1fv(GLuint indx, Float32Array values);
746 void vertexAttrib1fv(GLuint indx, sequence<GLfloat> values);
747 void vertexAttrib2f(GLuint indx, GLfloat x, GLfloat y);
748 void vertexAttrib2fv(GLuint indx, Float32Array values);
749 void vertexAttrib2fv(GLuint indx, sequence<GLfloat> values);
750 void vertexAttrib3f(GLuint indx, GLfloat x, GLfloat y, GLfloat z);
751 void vertexAttrib3fv(GLuint indx, Float32Array values);
752 void vertexAttrib3fv(GLuint indx, sequence<GLfloat> values);
753 void vertexAttrib4f(GLuint indx, GLfloat x, GLfloat y, GLfloat z, GLfloat w);
754 void vertexAttrib4fv(GLuint indx, Float32Array values);
755 void vertexAttrib4fv(GLuint indx, sequence<GLfloat> values);
756 void vertexAttribPointer(GLuint indx, GLint size, GLenum type,
757 GLboolean normalized, GLsizei stride, GLintptr offset);
759 void viewport(GLint x, GLint y, GLsizei width, GLsizei height);
760 };
762 /*[Constructor(DOMString type, optional WebGLContextEventInit eventInit)]
763 interface WebGLContextEvent : Event {
764 readonly attribute DOMString statusMessage;
765 };*/
767 // EventInit is defined in the DOM4 specification.
768 /*dictionary WebGLContextEventInit : EventInit {
769 DOMString statusMessage;
770 };*/
773 // specific extension interfaces
775 [NoInterfaceObject]
776 interface WebGLExtensionCompressedTextureS3TC
777 {
778 const GLenum COMPRESSED_RGB_S3TC_DXT1_EXT = 0x83F0;
779 const GLenum COMPRESSED_RGBA_S3TC_DXT1_EXT = 0x83F1;
780 const GLenum COMPRESSED_RGBA_S3TC_DXT3_EXT = 0x83F2;
781 const GLenum COMPRESSED_RGBA_S3TC_DXT5_EXT = 0x83F3;
782 };
784 [NoInterfaceObject]
785 interface WebGLExtensionCompressedTextureATC
786 {
787 const GLenum COMPRESSED_RGB_ATC_WEBGL = 0x8C92;
788 const GLenum COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL = 0x8C93;
789 const GLenum COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL = 0x87EE;
790 };
792 [NoInterfaceObject]
793 interface WebGLExtensionCompressedTextureETC1
794 {
795 const GLenum COMPRESSED_RGB_ETC1_WEBGL = 0x8D64;
796 };
798 [NoInterfaceObject]
799 interface WebGLExtensionCompressedTexturePVRTC
800 {
801 const GLenum COMPRESSED_RGB_PVRTC_4BPPV1 = 0x8C00;
802 const GLenum COMPRESSED_RGB_PVRTC_2BPPV1 = 0x8C01;
803 const GLenum COMPRESSED_RGBA_PVRTC_4BPPV1 = 0x8C02;
804 const GLenum COMPRESSED_RGBA_PVRTC_2BPPV1 = 0x8C03;
805 };
807 [NoInterfaceObject]
808 interface WebGLExtensionDebugRendererInfo
809 {
810 const GLenum UNMASKED_VENDOR_WEBGL = 0x9245;
811 const GLenum UNMASKED_RENDERER_WEBGL = 0x9246;
812 };
814 [NoInterfaceObject]
815 interface WebGLExtensionDebugShaders
816 {
817 DOMString getTranslatedShaderSource(WebGLShader? shader);
818 };
820 [NoInterfaceObject]
821 interface WebGLExtensionDepthTexture
822 {
823 const GLenum UNSIGNED_INT_24_8_WEBGL = 0x84FA;
824 };
826 [NoInterfaceObject]
827 interface WebGLExtensionElementIndexUint
828 {
829 };
831 [NoInterfaceObject]
832 interface WebGLExtensionFragDepth
833 {
834 };
836 [NoInterfaceObject]
837 interface WebGLExtensionLoseContext {
838 void loseContext();
839 void restoreContext();
840 };
842 [NoInterfaceObject]
843 interface WebGLExtensionTextureFilterAnisotropic
844 {
845 const GLenum TEXTURE_MAX_ANISOTROPY_EXT = 0x84FE;
846 const GLenum MAX_TEXTURE_MAX_ANISOTROPY_EXT = 0x84FF;
847 };
849 [NoInterfaceObject]
850 interface WebGLExtensionSRGB
851 {
852 const GLenum SRGB_EXT = 0x8C40;
853 const GLenum SRGB_ALPHA_EXT = 0x8C42;
854 const GLenum SRGB8_ALPHA8_EXT = 0x8C43;
855 const GLenum FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING_EXT = 0x8210;
856 };
858 [NoInterfaceObject]
859 interface WebGLExtensionStandardDerivatives {
860 const GLenum FRAGMENT_SHADER_DERIVATIVE_HINT_OES = 0x8B8B;
861 };
863 [NoInterfaceObject]
864 interface WebGLExtensionTextureFloat
865 {
866 };
868 [NoInterfaceObject]
869 interface WebGLExtensionDrawBuffers {
870 const GLenum COLOR_ATTACHMENT0_WEBGL = 0x8CE0;
871 const GLenum COLOR_ATTACHMENT1_WEBGL = 0x8CE1;
872 const GLenum COLOR_ATTACHMENT2_WEBGL = 0x8CE2;
873 const GLenum COLOR_ATTACHMENT3_WEBGL = 0x8CE3;
874 const GLenum COLOR_ATTACHMENT4_WEBGL = 0x8CE4;
875 const GLenum COLOR_ATTACHMENT5_WEBGL = 0x8CE5;
876 const GLenum COLOR_ATTACHMENT6_WEBGL = 0x8CE6;
877 const GLenum COLOR_ATTACHMENT7_WEBGL = 0x8CE7;
878 const GLenum COLOR_ATTACHMENT8_WEBGL = 0x8CE8;
879 const GLenum COLOR_ATTACHMENT9_WEBGL = 0x8CE9;
880 const GLenum COLOR_ATTACHMENT10_WEBGL = 0x8CEA;
881 const GLenum COLOR_ATTACHMENT11_WEBGL = 0x8CEB;
882 const GLenum COLOR_ATTACHMENT12_WEBGL = 0x8CEC;
883 const GLenum COLOR_ATTACHMENT13_WEBGL = 0x8CED;
884 const GLenum COLOR_ATTACHMENT14_WEBGL = 0x8CEE;
885 const GLenum COLOR_ATTACHMENT15_WEBGL = 0x8CEF;
887 const GLenum DRAW_BUFFER0_WEBGL = 0x8825;
888 const GLenum DRAW_BUFFER1_WEBGL = 0x8826;
889 const GLenum DRAW_BUFFER2_WEBGL = 0x8827;
890 const GLenum DRAW_BUFFER3_WEBGL = 0x8828;
891 const GLenum DRAW_BUFFER4_WEBGL = 0x8829;
892 const GLenum DRAW_BUFFER5_WEBGL = 0x882A;
893 const GLenum DRAW_BUFFER6_WEBGL = 0x882B;
894 const GLenum DRAW_BUFFER7_WEBGL = 0x882C;
895 const GLenum DRAW_BUFFER8_WEBGL = 0x882D;
896 const GLenum DRAW_BUFFER9_WEBGL = 0x882E;
897 const GLenum DRAW_BUFFER10_WEBGL = 0x882F;
898 const GLenum DRAW_BUFFER11_WEBGL = 0x8830;
899 const GLenum DRAW_BUFFER12_WEBGL = 0x8831;
900 const GLenum DRAW_BUFFER13_WEBGL = 0x8832;
901 const GLenum DRAW_BUFFER14_WEBGL = 0x8833;
902 const GLenum DRAW_BUFFER15_WEBGL = 0x8834;
904 const GLenum MAX_COLOR_ATTACHMENTS_WEBGL = 0x8CDF;
905 const GLenum MAX_DRAW_BUFFERS_WEBGL = 0x8824;
907 void drawBuffersWEBGL(sequence<GLenum> buffers);
908 };
910 [NoInterfaceObject]
911 interface WebGLExtensionTextureFloatLinear
912 {
913 };
915 [NoInterfaceObject]
916 interface WebGLExtensionTextureHalfFloat
917 {
918 const GLenum HALF_FLOAT_OES = 0x8D61;
919 };
921 [NoInterfaceObject]
922 interface WebGLExtensionTextureHalfFloatLinear
923 {
924 };
926 [NoInterfaceObject]
927 interface WebGLExtensionColorBufferFloat
928 {
929 const GLenum RGBA32F_EXT = 0x8814;
930 const GLenum RGB32F_EXT = 0x8815;
931 const GLenum FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE_EXT = 0x8211;
932 const GLenum UNSIGNED_NORMALIZED_EXT = 0x8C17;
933 };
935 [NoInterfaceObject]
936 interface WebGLExtensionColorBufferHalfFloat
937 {
938 const GLenum RGBA16F_EXT = 0x881A;
939 const GLenum RGB16F_EXT = 0x881B;
940 const GLenum FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE_EXT = 0x8211;
941 const GLenum UNSIGNED_NORMALIZED_EXT = 0x8C17;
942 };
944 [NoInterfaceObject]
945 interface WebGLExtensionVertexArray {
946 const GLenum VERTEX_ARRAY_BINDING_OES = 0x85B5;
948 WebGLVertexArray? createVertexArrayOES();
949 void deleteVertexArrayOES(WebGLVertexArray? arrayObject);
950 [WebGLHandlesContextLoss] GLboolean isVertexArrayOES(WebGLVertexArray? arrayObject);
951 void bindVertexArrayOES(WebGLVertexArray? arrayObject);
952 };
954 [NoInterfaceObject]
955 interface WebGLExtensionInstancedArrays {
956 const GLenum VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE = 0x88FE;
958 void drawArraysInstancedANGLE(GLenum mode, GLint first, GLsizei count, GLsizei primcount);
959 void drawElementsInstancedANGLE(GLenum mode, GLsizei count, GLenum type, GLintptr offset, GLsizei primcount);
960 void vertexAttribDivisorANGLE(GLuint index, GLuint divisor);
961 };