1/*
2 * Copyright (C) 2009 Apple Inc. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 * 1. Redistributions of source code must retain the above copyright
8 *    notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 *    notice, this list of conditions and the following disclaimer in the
11 *    documentation and/or other materials provided with the distribution.
12 *
13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24 */
25
26typedef unsigned long  GLenum;
27typedef boolean        GLboolean;
28typedef unsigned long  GLbitfield;
29typedef byte           GLbyte;         /* 'byte' should be a signed 8 bit type. */
30typedef short          GLshort;
31typedef long           GLint;
32typedef long           GLsizei;
33typedef long long      GLintptr;
34typedef long long      GLsizeiptr;
35typedef octet          GLubyte;        /* 'octet' should be an unsigned 8 bit type. */
36typedef unsigned short GLushort;
37typedef unsigned long  GLuint;
38typedef unrestricted float GLfloat;
39typedef unrestricted float GLclampf;
40
41[
42    Conditional=WEBGL,
43    JSCustomMarkFunction,
44    DoNotCheckConstants,
45] interface WebGLRenderingContext : CanvasRenderingContext {
46
47    /* ClearBufferMask */
48    const GLenum DEPTH_BUFFER_BIT               = 0x00000100;
49    const GLenum STENCIL_BUFFER_BIT             = 0x00000400;
50    const GLenum COLOR_BUFFER_BIT               = 0x00004000;
51
52    /* BeginMode */
53    const GLenum POINTS                         = 0x0000;
54    const GLenum LINES                          = 0x0001;
55    const GLenum LINE_LOOP                      = 0x0002;
56    const GLenum LINE_STRIP                     = 0x0003;
57    const GLenum TRIANGLES                      = 0x0004;
58    const GLenum TRIANGLE_STRIP                 = 0x0005;
59    const GLenum TRIANGLE_FAN                   = 0x0006;
60
61    /* AlphaFunction (not supported in ES20) */
62    /*      NEVER */
63    /*      LESS */
64    /*      EQUAL */
65    /*      LEQUAL */
66    /*      GREATER */
67    /*      NOTEQUAL */
68    /*      GEQUAL */
69    /*      ALWAYS */
70
71    /* BlendingFactorDest */
72    const GLenum ZERO                           = 0;
73    const GLenum ONE                            = 1;
74    const GLenum SRC_COLOR                      = 0x0300;
75    const GLenum ONE_MINUS_SRC_COLOR            = 0x0301;
76    const GLenum SRC_ALPHA                      = 0x0302;
77    const GLenum ONE_MINUS_SRC_ALPHA            = 0x0303;
78    const GLenum DST_ALPHA                      = 0x0304;
79    const GLenum ONE_MINUS_DST_ALPHA            = 0x0305;
80
81    /* BlendingFactorSrc */
82    /*      ZERO */
83    /*      ONE */
84    const GLenum DST_COLOR                      = 0x0306;
85    const GLenum ONE_MINUS_DST_COLOR            = 0x0307;
86    const GLenum SRC_ALPHA_SATURATE             = 0x0308;
87    /*      SRC_ALPHA */
88    /*      ONE_MINUS_SRC_ALPHA */
89    /*      DST_ALPHA */
90    /*      ONE_MINUS_DST_ALPHA */
91
92    /* BlendEquationSeparate */
93    const GLenum FUNC_ADD                       = 0x8006;
94    const GLenum BLEND_EQUATION                 = 0x8009;
95    const GLenum BLEND_EQUATION_RGB             = 0x8009;   /* same as BLEND_EQUATION */
96    const GLenum BLEND_EQUATION_ALPHA           = 0x883D;
97
98    /* BlendSubtract */
99    const GLenum FUNC_SUBTRACT                  = 0x800A;
100    const GLenum FUNC_REVERSE_SUBTRACT          = 0x800B;
101
102    /* Separate Blend Functions */
103    const GLenum BLEND_DST_RGB                  = 0x80C8;
104    const GLenum BLEND_SRC_RGB                  = 0x80C9;
105    const GLenum BLEND_DST_ALPHA                = 0x80CA;
106    const GLenum BLEND_SRC_ALPHA                = 0x80CB;
107    const GLenum CONSTANT_COLOR                 = 0x8001;
108    const GLenum ONE_MINUS_CONSTANT_COLOR       = 0x8002;
109    const GLenum CONSTANT_ALPHA                 = 0x8003;
110    const GLenum ONE_MINUS_CONSTANT_ALPHA       = 0x8004;
111    const GLenum BLEND_COLOR                    = 0x8005;
112
113    /* Buffer Objects */
114    const GLenum ARRAY_BUFFER                   = 0x8892;
115    const GLenum ELEMENT_ARRAY_BUFFER           = 0x8893;
116    const GLenum ARRAY_BUFFER_BINDING           = 0x8894;
117    const GLenum ELEMENT_ARRAY_BUFFER_BINDING   = 0x8895;
118
119    const GLenum STREAM_DRAW                    = 0x88E0;
120    const GLenum STATIC_DRAW                    = 0x88E4;
121    const GLenum DYNAMIC_DRAW                   = 0x88E8;
122
123    const GLenum BUFFER_SIZE                    = 0x8764;
124    const GLenum BUFFER_USAGE                   = 0x8765;
125
126    const GLenum CURRENT_VERTEX_ATTRIB          = 0x8626;
127
128    /* CullFaceMode */
129    const GLenum FRONT                          = 0x0404;
130    const GLenum BACK                           = 0x0405;
131    const GLenum FRONT_AND_BACK                 = 0x0408;
132
133    /* DepthFunction */
134    /*      NEVER */
135    /*      LESS */
136    /*      EQUAL */
137    /*      LEQUAL */
138    /*      GREATER */
139    /*      NOTEQUAL */
140    /*      GEQUAL */
141    /*      ALWAYS */
142
143    /* EnableCap */
144    const GLenum TEXTURE_2D                     = 0x0DE1;
145    const GLenum CULL_FACE                      = 0x0B44;
146    const GLenum BLEND                          = 0x0BE2;
147    const GLenum DITHER                         = 0x0BD0;
148    const GLenum STENCIL_TEST                   = 0x0B90;
149    const GLenum DEPTH_TEST                     = 0x0B71;
150    const GLenum SCISSOR_TEST                   = 0x0C11;
151    const GLenum POLYGON_OFFSET_FILL            = 0x8037;
152    const GLenum SAMPLE_ALPHA_TO_COVERAGE       = 0x809E;
153    const GLenum SAMPLE_COVERAGE                = 0x80A0;
154
155    /* ErrorCode */
156    const GLenum NO_ERROR                       = 0;
157    const GLenum INVALID_ENUM                   = 0x0500;
158    const GLenum INVALID_VALUE                  = 0x0501;
159    const GLenum INVALID_OPERATION              = 0x0502;
160    const GLenum OUT_OF_MEMORY                  = 0x0505;
161
162    /* FrontFaceDirection */
163    const GLenum CW                             = 0x0900;
164    const GLenum CCW                            = 0x0901;
165
166    /* GetPName */
167    const GLenum LINE_WIDTH                     = 0x0B21;
168    const GLenum ALIASED_POINT_SIZE_RANGE       = 0x846D;
169    const GLenum ALIASED_LINE_WIDTH_RANGE       = 0x846E;
170    const GLenum CULL_FACE_MODE                 = 0x0B45;
171    const GLenum FRONT_FACE                     = 0x0B46;
172    const GLenum DEPTH_RANGE                    = 0x0B70;
173    const GLenum DEPTH_WRITEMASK                = 0x0B72;
174    const GLenum DEPTH_CLEAR_VALUE              = 0x0B73;
175    const GLenum DEPTH_FUNC                     = 0x0B74;
176    const GLenum STENCIL_CLEAR_VALUE            = 0x0B91;
177    const GLenum STENCIL_FUNC                   = 0x0B92;
178    const GLenum STENCIL_FAIL                   = 0x0B94;
179    const GLenum STENCIL_PASS_DEPTH_FAIL        = 0x0B95;
180    const GLenum STENCIL_PASS_DEPTH_PASS        = 0x0B96;
181    const GLenum STENCIL_REF                    = 0x0B97;
182    const GLenum STENCIL_VALUE_MASK             = 0x0B93;
183    const GLenum STENCIL_WRITEMASK              = 0x0B98;
184    const GLenum STENCIL_BACK_FUNC              = 0x8800;
185    const GLenum STENCIL_BACK_FAIL              = 0x8801;
186    const GLenum STENCIL_BACK_PASS_DEPTH_FAIL   = 0x8802;
187    const GLenum STENCIL_BACK_PASS_DEPTH_PASS   = 0x8803;
188    const GLenum STENCIL_BACK_REF               = 0x8CA3;
189    const GLenum STENCIL_BACK_VALUE_MASK        = 0x8CA4;
190    const GLenum STENCIL_BACK_WRITEMASK         = 0x8CA5;
191    const GLenum VIEWPORT                       = 0x0BA2;
192    const GLenum SCISSOR_BOX                    = 0x0C10;
193    /*      SCISSOR_TEST */
194    const GLenum COLOR_CLEAR_VALUE              = 0x0C22;
195    const GLenum COLOR_WRITEMASK                = 0x0C23;
196    const GLenum UNPACK_ALIGNMENT               = 0x0CF5;
197    const GLenum PACK_ALIGNMENT                 = 0x0D05;
198    const GLenum MAX_TEXTURE_SIZE               = 0x0D33;
199    const GLenum MAX_VIEWPORT_DIMS              = 0x0D3A;
200    const GLenum SUBPIXEL_BITS                  = 0x0D50;
201    const GLenum RED_BITS                       = 0x0D52;
202    const GLenum GREEN_BITS                     = 0x0D53;
203    const GLenum BLUE_BITS                      = 0x0D54;
204    const GLenum ALPHA_BITS                     = 0x0D55;
205    const GLenum DEPTH_BITS                     = 0x0D56;
206    const GLenum STENCIL_BITS                   = 0x0D57;
207    const GLenum POLYGON_OFFSET_UNITS           = 0x2A00;
208    /*      POLYGON_OFFSET_FILL */
209    const GLenum POLYGON_OFFSET_FACTOR          = 0x8038;
210    const GLenum TEXTURE_BINDING_2D             = 0x8069;
211    const GLenum SAMPLE_BUFFERS                 = 0x80A8;
212    const GLenum SAMPLES                        = 0x80A9;
213    const GLenum SAMPLE_COVERAGE_VALUE          = 0x80AA;
214    const GLenum SAMPLE_COVERAGE_INVERT         = 0x80AB;
215
216    /* GetTextureParameter */
217    /*      TEXTURE_MAG_FILTER */
218    /*      TEXTURE_MIN_FILTER */
219    /*      TEXTURE_WRAP_S */
220    /*      TEXTURE_WRAP_T */
221
222    const GLenum COMPRESSED_TEXTURE_FORMATS     = 0x86A3;
223
224    /* HintMode */
225    const GLenum DONT_CARE                      = 0x1100;
226    const GLenum FASTEST                        = 0x1101;
227    const GLenum NICEST                         = 0x1102;
228
229    /* HintTarget */
230    const GLenum GENERATE_MIPMAP_HINT            = 0x8192;
231
232    /* DataType */
233    const GLenum BYTE                           = 0x1400;
234    const GLenum UNSIGNED_BYTE                  = 0x1401;
235    const GLenum SHORT                          = 0x1402;
236    const GLenum UNSIGNED_SHORT                 = 0x1403;
237    const GLenum INT                            = 0x1404;
238    const GLenum UNSIGNED_INT                   = 0x1405;
239    const GLenum FLOAT                          = 0x1406;
240
241    /* PixelFormat */
242    const GLenum DEPTH_COMPONENT                = 0x1902;
243    const GLenum ALPHA                          = 0x1906;
244    const GLenum RGB                            = 0x1907;
245    const GLenum RGBA                           = 0x1908;
246    const GLenum LUMINANCE                      = 0x1909;
247    const GLenum LUMINANCE_ALPHA                = 0x190A;
248
249    /* PixelType */
250    /*      UNSIGNED_BYTE */
251    const GLenum UNSIGNED_SHORT_4_4_4_4         = 0x8033;
252    const GLenum UNSIGNED_SHORT_5_5_5_1         = 0x8034;
253    const GLenum UNSIGNED_SHORT_5_6_5           = 0x8363;
254
255    /* Shaders */
256    const GLenum FRAGMENT_SHADER                  = 0x8B30;
257    const GLenum VERTEX_SHADER                    = 0x8B31;
258    const GLenum MAX_VERTEX_ATTRIBS               = 0x8869;
259    const GLenum MAX_VERTEX_UNIFORM_VECTORS       = 0x8DFB;
260    const GLenum MAX_VARYING_VECTORS              = 0x8DFC;
261    const GLenum MAX_COMBINED_TEXTURE_IMAGE_UNITS = 0x8B4D;
262    const GLenum MAX_VERTEX_TEXTURE_IMAGE_UNITS   = 0x8B4C;
263    const GLenum MAX_TEXTURE_IMAGE_UNITS          = 0x8872;
264    const GLenum MAX_FRAGMENT_UNIFORM_VECTORS     = 0x8DFD;
265    const GLenum SHADER_TYPE                      = 0x8B4F;
266    const GLenum DELETE_STATUS                    = 0x8B80;
267    const GLenum LINK_STATUS                      = 0x8B82;
268    const GLenum VALIDATE_STATUS                  = 0x8B83;
269    const GLenum ATTACHED_SHADERS                 = 0x8B85;
270    const GLenum ACTIVE_UNIFORMS                  = 0x8B86;
271    const GLenum ACTIVE_ATTRIBUTES                = 0x8B89;
272    const GLenum SHADING_LANGUAGE_VERSION         = 0x8B8C;
273    const GLenum CURRENT_PROGRAM                  = 0x8B8D;
274
275    /* StencilFunction */
276    const GLenum NEVER                          = 0x0200;
277    const GLenum LESS                           = 0x0201;
278    const GLenum EQUAL                          = 0x0202;
279    const GLenum LEQUAL                         = 0x0203;
280    const GLenum GREATER                        = 0x0204;
281    const GLenum NOTEQUAL                       = 0x0205;
282    const GLenum GEQUAL                         = 0x0206;
283    const GLenum ALWAYS                         = 0x0207;
284
285    /* StencilOp */
286    /*      ZERO */
287    const GLenum KEEP                           = 0x1E00;
288    const GLenum REPLACE                        = 0x1E01;
289    const GLenum INCR                           = 0x1E02;
290    const GLenum DECR                           = 0x1E03;
291    const GLenum INVERT                         = 0x150A;
292    const GLenum INCR_WRAP                      = 0x8507;
293    const GLenum DECR_WRAP                      = 0x8508;
294
295    /* StringName */
296    const GLenum VENDOR                         = 0x1F00;
297    const GLenum RENDERER                       = 0x1F01;
298    const GLenum VERSION                        = 0x1F02;
299
300    /* TextureMagFilter */
301    const GLenum NEAREST                        = 0x2600;
302    const GLenum LINEAR                         = 0x2601;
303
304    /* TextureMinFilter */
305    /*      NEAREST */
306    /*      LINEAR */
307    const GLenum NEAREST_MIPMAP_NEAREST         = 0x2700;
308    const GLenum LINEAR_MIPMAP_NEAREST          = 0x2701;
309    const GLenum NEAREST_MIPMAP_LINEAR          = 0x2702;
310    const GLenum LINEAR_MIPMAP_LINEAR           = 0x2703;
311
312    /* TextureParameterName */
313    const GLenum TEXTURE_MAG_FILTER             = 0x2800;
314    const GLenum TEXTURE_MIN_FILTER             = 0x2801;
315    const GLenum TEXTURE_WRAP_S                 = 0x2802;
316    const GLenum TEXTURE_WRAP_T                 = 0x2803;
317
318    /* TextureTarget */
319    /*      TEXTURE_2D */
320    const GLenum TEXTURE                        = 0x1702;
321
322    const GLenum TEXTURE_CUBE_MAP               = 0x8513;
323    const GLenum TEXTURE_BINDING_CUBE_MAP       = 0x8514;
324    const GLenum TEXTURE_CUBE_MAP_POSITIVE_X    = 0x8515;
325    const GLenum TEXTURE_CUBE_MAP_NEGATIVE_X    = 0x8516;
326    const GLenum TEXTURE_CUBE_MAP_POSITIVE_Y    = 0x8517;
327    const GLenum TEXTURE_CUBE_MAP_NEGATIVE_Y    = 0x8518;
328    const GLenum TEXTURE_CUBE_MAP_POSITIVE_Z    = 0x8519;
329    const GLenum TEXTURE_CUBE_MAP_NEGATIVE_Z    = 0x851A;
330    const GLenum MAX_CUBE_MAP_TEXTURE_SIZE      = 0x851C;
331
332    /* TextureUnit */
333    const GLenum TEXTURE0                       = 0x84C0;
334    const GLenum TEXTURE1                       = 0x84C1;
335    const GLenum TEXTURE2                       = 0x84C2;
336    const GLenum TEXTURE3                       = 0x84C3;
337    const GLenum TEXTURE4                       = 0x84C4;
338    const GLenum TEXTURE5                       = 0x84C5;
339    const GLenum TEXTURE6                       = 0x84C6;
340    const GLenum TEXTURE7                       = 0x84C7;
341    const GLenum TEXTURE8                       = 0x84C8;
342    const GLenum TEXTURE9                       = 0x84C9;
343    const GLenum TEXTURE10                      = 0x84CA;
344    const GLenum TEXTURE11                      = 0x84CB;
345    const GLenum TEXTURE12                      = 0x84CC;
346    const GLenum TEXTURE13                      = 0x84CD;
347    const GLenum TEXTURE14                      = 0x84CE;
348    const GLenum TEXTURE15                      = 0x84CF;
349    const GLenum TEXTURE16                      = 0x84D0;
350    const GLenum TEXTURE17                      = 0x84D1;
351    const GLenum TEXTURE18                      = 0x84D2;
352    const GLenum TEXTURE19                      = 0x84D3;
353    const GLenum TEXTURE20                      = 0x84D4;
354    const GLenum TEXTURE21                      = 0x84D5;
355    const GLenum TEXTURE22                      = 0x84D6;
356    const GLenum TEXTURE23                      = 0x84D7;
357    const GLenum TEXTURE24                      = 0x84D8;
358    const GLenum TEXTURE25                      = 0x84D9;
359    const GLenum TEXTURE26                      = 0x84DA;
360    const GLenum TEXTURE27                      = 0x84DB;
361    const GLenum TEXTURE28                      = 0x84DC;
362    const GLenum TEXTURE29                      = 0x84DD;
363    const GLenum TEXTURE30                      = 0x84DE;
364    const GLenum TEXTURE31                      = 0x84DF;
365    const GLenum ACTIVE_TEXTURE                 = 0x84E0;
366
367    /* TextureWrapMode */
368    const GLenum REPEAT                         = 0x2901;
369    const GLenum CLAMP_TO_EDGE                  = 0x812F;
370    const GLenum MIRRORED_REPEAT                = 0x8370;
371
372    /* Uniform Types */
373    const GLenum FLOAT_VEC2                     = 0x8B50;
374    const GLenum FLOAT_VEC3                     = 0x8B51;
375    const GLenum FLOAT_VEC4                     = 0x8B52;
376    const GLenum INT_VEC2                       = 0x8B53;
377    const GLenum INT_VEC3                       = 0x8B54;
378    const GLenum INT_VEC4                       = 0x8B55;
379    const GLenum BOOL                           = 0x8B56;
380    const GLenum BOOL_VEC2                      = 0x8B57;
381    const GLenum BOOL_VEC3                      = 0x8B58;
382    const GLenum BOOL_VEC4                      = 0x8B59;
383    const GLenum FLOAT_MAT2                     = 0x8B5A;
384    const GLenum FLOAT_MAT3                     = 0x8B5B;
385    const GLenum FLOAT_MAT4                     = 0x8B5C;
386    const GLenum SAMPLER_2D                     = 0x8B5E;
387    const GLenum SAMPLER_CUBE                   = 0x8B60;
388
389    /* Vertex Arrays */
390    const GLenum VERTEX_ATTRIB_ARRAY_ENABLED        = 0x8622;
391    const GLenum VERTEX_ATTRIB_ARRAY_SIZE           = 0x8623;
392    const GLenum VERTEX_ATTRIB_ARRAY_STRIDE         = 0x8624;
393    const GLenum VERTEX_ATTRIB_ARRAY_TYPE           = 0x8625;
394    const GLenum VERTEX_ATTRIB_ARRAY_NORMALIZED     = 0x886A;
395    const GLenum VERTEX_ATTRIB_ARRAY_POINTER        = 0x8645;
396    const GLenum VERTEX_ATTRIB_ARRAY_BUFFER_BINDING = 0x889F;
397
398    /* Shader Source */
399    const GLenum COMPILE_STATUS                 = 0x8B81;
400
401    /* Shader Precision-Specified Types */
402    const GLenum LOW_FLOAT                      = 0x8DF0;
403    const GLenum MEDIUM_FLOAT                   = 0x8DF1;
404    const GLenum HIGH_FLOAT                     = 0x8DF2;
405    const GLenum LOW_INT                        = 0x8DF3;
406    const GLenum MEDIUM_INT                     = 0x8DF4;
407    const GLenum HIGH_INT                       = 0x8DF5;
408
409    /* Framebuffer Object. */
410    const GLenum FRAMEBUFFER                    = 0x8D40;
411    const GLenum RENDERBUFFER                   = 0x8D41;
412
413    const GLenum RGBA4                          = 0x8056;
414    const GLenum RGB5_A1                        = 0x8057;
415    const GLenum RGB565                         = 0x8D62;
416    const GLenum DEPTH_COMPONENT16              = 0x81A5;
417    const GLenum STENCIL_INDEX                  = 0x1901;
418    const GLenum STENCIL_INDEX8                 = 0x8D48;
419    const GLenum DEPTH_STENCIL                  = 0x84F9;
420
421    const GLenum RENDERBUFFER_WIDTH             = 0x8D42;
422    const GLenum RENDERBUFFER_HEIGHT            = 0x8D43;
423    const GLenum RENDERBUFFER_INTERNAL_FORMAT   = 0x8D44;
424    const GLenum RENDERBUFFER_RED_SIZE          = 0x8D50;
425    const GLenum RENDERBUFFER_GREEN_SIZE        = 0x8D51;
426    const GLenum RENDERBUFFER_BLUE_SIZE         = 0x8D52;
427    const GLenum RENDERBUFFER_ALPHA_SIZE        = 0x8D53;
428    const GLenum RENDERBUFFER_DEPTH_SIZE        = 0x8D54;
429    const GLenum RENDERBUFFER_STENCIL_SIZE      = 0x8D55;
430
431    const GLenum FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE           = 0x8CD0;
432    const GLenum FRAMEBUFFER_ATTACHMENT_OBJECT_NAME           = 0x8CD1;
433    const GLenum FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL         = 0x8CD2;
434    const GLenum FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE = 0x8CD3;
435
436    const GLenum COLOR_ATTACHMENT0              = 0x8CE0;
437    const GLenum DEPTH_ATTACHMENT               = 0x8D00;
438    const GLenum STENCIL_ATTACHMENT             = 0x8D20;
439    const GLenum DEPTH_STENCIL_ATTACHMENT       = 0x821A;
440
441    const GLenum NONE                           = 0;
442
443    const GLenum FRAMEBUFFER_COMPLETE                      = 0x8CD5;
444    const GLenum FRAMEBUFFER_INCOMPLETE_ATTACHMENT         = 0x8CD6;
445    const GLenum FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT = 0x8CD7;
446    const GLenum FRAMEBUFFER_INCOMPLETE_DIMENSIONS         = 0x8CD9;
447    const GLenum FRAMEBUFFER_UNSUPPORTED                   = 0x8CDD;
448
449    const GLenum FRAMEBUFFER_BINDING            = 0x8CA6;
450    const GLenum RENDERBUFFER_BINDING           = 0x8CA7;
451    const GLenum MAX_RENDERBUFFER_SIZE          = 0x84E8;
452
453    const GLenum INVALID_FRAMEBUFFER_OPERATION  = 0x0506;
454
455    /* WebGL-specific enums */
456    const GLenum UNPACK_FLIP_Y_WEBGL                = 0x9240;
457    const GLenum UNPACK_PREMULTIPLY_ALPHA_WEBGL     = 0x9241;
458    const GLenum CONTEXT_LOST_WEBGL                 = 0x9242;
459    const GLenum UNPACK_COLORSPACE_CONVERSION_WEBGL = 0x9243;
460    const GLenum BROWSER_DEFAULT_WEBGL              = 0x9244;
461
462    readonly attribute GLsizei drawingBufferWidth;
463    readonly attribute GLsizei drawingBufferHeight;
464
465    [StrictTypeChecking, RaisesException] void         activeTexture(GLenum texture);
466    [StrictTypeChecking, RaisesException] void         attachShader(WebGLProgram program, WebGLShader shader);
467    [StrictTypeChecking, RaisesException] void         bindAttribLocation(WebGLProgram program, GLuint index, DOMString name);
468    [StrictTypeChecking, RaisesException] void         bindBuffer(GLenum target, WebGLBuffer buffer);
469    [StrictTypeChecking, RaisesException] void         bindFramebuffer(GLenum target, WebGLFramebuffer framebuffer);
470    [StrictTypeChecking, RaisesException] void         bindRenderbuffer(GLenum target, WebGLRenderbuffer renderbuffer);
471    [StrictTypeChecking, RaisesException] void         bindTexture(GLenum target, WebGLTexture texture);
472    [StrictTypeChecking] void         blendColor(GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha);
473    [StrictTypeChecking] void         blendEquation(GLenum mode);
474    [StrictTypeChecking] void         blendEquationSeparate(GLenum modeRGB, GLenum modeAlpha);
475    [StrictTypeChecking] void         blendFunc(GLenum sfactor, GLenum dfactor);
476    [StrictTypeChecking] void         blendFuncSeparate(GLenum srcRGB, GLenum dstRGB, GLenum srcAlpha, GLenum dstAlpha);
477    [StrictTypeChecking, RaisesException] void         bufferData(GLenum target, ArrayBuffer? data, GLenum usage);
478    [StrictTypeChecking, RaisesException] void         bufferData(GLenum target, ArrayBufferView? data, GLenum usage);
479    [StrictTypeChecking, RaisesException] void         bufferData(GLenum target, GLsizeiptr size, GLenum usage);
480    [StrictTypeChecking, RaisesException] void         bufferSubData(GLenum target, GLintptr offset, ArrayBuffer? data);
481    [StrictTypeChecking, RaisesException] void         bufferSubData(GLenum target, GLintptr offset, ArrayBufferView? data);
482
483    [StrictTypeChecking] GLenum       checkFramebufferStatus(GLenum target);
484    [StrictTypeChecking] void         clear(GLbitfield mask);
485    [StrictTypeChecking] void         clearColor(GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha);
486    [StrictTypeChecking] void         clearDepth(GLclampf depth);
487    [StrictTypeChecking] void         clearStencil(GLint s);
488    [StrictTypeChecking] void         colorMask(GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha);
489    [StrictTypeChecking, RaisesException] void         compileShader(WebGLShader shader);
490
491    [StrictTypeChecking] void         compressedTexImage2D(GLenum target, GLint level, GLenum internalformat,
492                                                           GLsizei width, GLsizei height, GLint border, ArrayBufferView data);
493    [StrictTypeChecking] void         compressedTexSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
494                                                              GLsizei width, GLsizei height, GLenum format, ArrayBufferView data);
495
496    [StrictTypeChecking] void         copyTexImage2D(GLenum target, GLint level, GLenum internalformat, GLint x, GLint y, GLsizei width, GLsizei height, GLint border);
497    [StrictTypeChecking] void         copyTexSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset, GLint x, GLint y, GLsizei width, GLsizei height);
498
499    [StrictTypeChecking] WebGLBuffer createBuffer();
500    [StrictTypeChecking] WebGLFramebuffer createFramebuffer();
501    [StrictTypeChecking] WebGLProgram createProgram();
502    [StrictTypeChecking] WebGLRenderbuffer createRenderbuffer();
503    [StrictTypeChecking, RaisesException] WebGLShader createShader(GLenum type);
504    [StrictTypeChecking] WebGLTexture createTexture();
505
506    [StrictTypeChecking] void         cullFace(GLenum mode);
507
508    [StrictTypeChecking] void         deleteBuffer(WebGLBuffer buffer);
509    [StrictTypeChecking] void         deleteFramebuffer(WebGLFramebuffer framebuffer);
510    [StrictTypeChecking] void         deleteProgram(WebGLProgram program);
511    [StrictTypeChecking] void         deleteRenderbuffer(WebGLRenderbuffer renderbuffer);
512    [StrictTypeChecking] void         deleteShader(WebGLShader shader);
513    [StrictTypeChecking] void         deleteTexture(WebGLTexture texture);
514
515    [StrictTypeChecking] void         depthFunc(GLenum func);
516    [StrictTypeChecking] void         depthMask(GLboolean flag);
517    [StrictTypeChecking] void         depthRange(GLclampf zNear, GLclampf zFar);
518    [StrictTypeChecking, RaisesException] void         detachShader(WebGLProgram program, WebGLShader shader);
519    [StrictTypeChecking] void         disable(GLenum cap);
520    [StrictTypeChecking, RaisesException] void         disableVertexAttribArray(GLuint index);
521    [StrictTypeChecking, RaisesException] void         drawArrays(GLenum mode, GLint first, GLsizei count);
522    [StrictTypeChecking, RaisesException] void         drawElements(GLenum mode, GLsizei count, GLenum type, GLintptr offset);
523
524    [StrictTypeChecking] void         enable(GLenum cap);
525    [StrictTypeChecking, RaisesException] void         enableVertexAttribArray(GLuint index);
526    [StrictTypeChecking] void         finish();
527    [StrictTypeChecking] void         flush();
528    [StrictTypeChecking, RaisesException] void         framebufferRenderbuffer(GLenum target, GLenum attachment, GLenum renderbuffertarget, WebGLRenderbuffer renderbuffer);
529    [StrictTypeChecking, RaisesException] void         framebufferTexture2D(GLenum target, GLenum attachment, GLenum textarget, WebGLTexture texture, GLint level);
530    [StrictTypeChecking] void         frontFace(GLenum mode);
531    [StrictTypeChecking] void         generateMipmap(GLenum target);
532
533    [StrictTypeChecking, RaisesException] WebGLActiveInfo getActiveAttrib(WebGLProgram program, GLuint index);
534    [StrictTypeChecking, RaisesException] WebGLActiveInfo getActiveUniform(WebGLProgram program, GLuint index);
535
536    [StrictTypeChecking, Custom, RaisesException] void getAttachedShaders(WebGLProgram program);
537
538    [StrictTypeChecking] GLint        getAttribLocation(WebGLProgram program, DOMString name);
539
540    [StrictTypeChecking, Custom] any getBufferParameter(GLenum target, GLenum pname);
541
542    [StrictTypeChecking] WebGLContextAttributes getContextAttributes();
543
544    [StrictTypeChecking] GLenum getError();
545
546    // object getExtension(DOMString name);
547    [StrictTypeChecking, Custom] any getExtension(DOMString name);
548
549    [StrictTypeChecking, Custom, RaisesException] any getFramebufferAttachmentParameter(GLenum target, GLenum attachment, GLenum pname);
550    [StrictTypeChecking, Custom, RaisesException] any getParameter(GLenum pname);
551    [StrictTypeChecking, Custom, RaisesException] any getProgramParameter(WebGLProgram program, GLenum pname);
552    [StrictTypeChecking, TreatReturnedNullStringAs=Null, RaisesException] DOMString getProgramInfoLog(WebGLProgram program);
553    [StrictTypeChecking, Custom, RaisesException] any getRenderbufferParameter(GLenum target, GLenum pname);
554    [StrictTypeChecking, Custom, RaisesException] any getShaderParameter(WebGLShader shader, GLenum pname);
555
556    [StrictTypeChecking, TreatReturnedNullStringAs=Null, RaisesException] DOMString    getShaderInfoLog(WebGLShader shader);
557
558    [StrictTypeChecking, RaisesException] WebGLShaderPrecisionFormat getShaderPrecisionFormat(GLenum shadertype, GLenum precisiontype);
559
560    [StrictTypeChecking, TreatReturnedNullStringAs=Null, RaisesException] DOMString    getShaderSource(WebGLShader shader);
561
562    [StrictTypeChecking, Custom] sequence<DOMString> getSupportedExtensions();
563
564    [StrictTypeChecking, Custom, RaisesException] any getTexParameter(GLenum target, GLenum pname);
565
566    [StrictTypeChecking, Custom, RaisesException] any getUniform(WebGLProgram program, WebGLUniformLocation location);
567
568    [StrictTypeChecking, RaisesException] WebGLUniformLocation getUniformLocation(WebGLProgram program, DOMString name);
569
570    [StrictTypeChecking, Custom, RaisesException] any getVertexAttrib(GLuint index, GLenum pname);
571
572    [StrictTypeChecking] GLsizeiptr getVertexAttribOffset(GLuint index, GLenum pname);
573
574    [StrictTypeChecking] void         hint(GLenum target, GLenum mode);
575    [StrictTypeChecking] GLboolean    isBuffer(WebGLBuffer buffer);
576    [StrictTypeChecking] GLboolean    isContextLost();
577    [StrictTypeChecking] GLboolean    isEnabled(GLenum cap);
578    [StrictTypeChecking] GLboolean    isFramebuffer(WebGLFramebuffer framebuffer);
579    [StrictTypeChecking] GLboolean    isProgram(WebGLProgram program);
580    [StrictTypeChecking] GLboolean    isRenderbuffer(WebGLRenderbuffer renderbuffer);
581    [StrictTypeChecking] GLboolean    isShader(WebGLShader shader);
582    [StrictTypeChecking] GLboolean    isTexture(WebGLTexture texture);
583    [StrictTypeChecking] void         lineWidth(GLfloat width);
584    [StrictTypeChecking, RaisesException] void         linkProgram(WebGLProgram program);
585    [StrictTypeChecking] void         pixelStorei(GLenum pname, GLint param);
586    [StrictTypeChecking] void         polygonOffset(GLfloat factor, GLfloat units);
587
588    [StrictTypeChecking, RaisesException] void         readPixels(GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, ArrayBufferView pixels);
589
590    [StrictTypeChecking] void         releaseShaderCompiler();
591    [StrictTypeChecking] void         renderbufferStorage(GLenum target, GLenum internalformat, GLsizei width, GLsizei height);
592    [StrictTypeChecking] void         sampleCoverage(GLclampf value, GLboolean invert);
593    [StrictTypeChecking] void         scissor(GLint x, GLint y, GLsizei width, GLsizei height);
594    [StrictTypeChecking, RaisesException] void         shaderSource(WebGLShader shader, DOMString string);
595    [StrictTypeChecking] void         stencilFunc(GLenum func, GLint ref, GLuint mask);
596    [StrictTypeChecking] void         stencilFuncSeparate(GLenum face, GLenum func, GLint ref, GLuint mask);
597    [StrictTypeChecking] void         stencilMask(GLuint mask);
598    [StrictTypeChecking] void         stencilMaskSeparate(GLenum face, GLuint mask);
599    [StrictTypeChecking] void         stencilOp(GLenum fail, GLenum zfail, GLenum zpass);
600    [StrictTypeChecking] void         stencilOpSeparate(GLenum face, GLenum fail, GLenum zfail, GLenum zpass);
601
602    [StrictTypeChecking] void         texParameterf(GLenum target, GLenum pname, GLfloat param);
603    [StrictTypeChecking] void         texParameteri(GLenum target, GLenum pname, GLint param);
604
605    // Supported forms:
606    [StrictTypeChecking, RaisesException] void         texImage2D(GLenum target, GLint level, GLenum internalformat, GLsizei width, GLsizei height,
607                                                 GLint border, GLenum format, GLenum type, ArrayBufferView? pixels);
608    [StrictTypeChecking, RaisesException] void         texImage2D(GLenum target, GLint level, GLenum internalformat,
609                                                 GLenum format, GLenum type, ImageData? pixels);
610    [StrictTypeChecking, RaisesException] void         texImage2D(GLenum target, GLint level, GLenum internalformat,
611                                                 GLenum format, GLenum type, HTMLImageElement? image);
612    [StrictTypeChecking, RaisesException] void         texImage2D(GLenum target, GLint level, GLenum internalformat,
613                                                 GLenum format, GLenum type, HTMLCanvasElement? canvas);
614#if defined(ENABLE_VIDEO) && ENABLE_VIDEO
615    [StrictTypeChecking, RaisesException] void         texImage2D(GLenum target, GLint level, GLenum internalformat,
616                                                 GLenum format, GLenum type, HTMLVideoElement? video);
617#endif
618
619    [StrictTypeChecking, RaisesException] void         texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
620                                                    GLsizei width, GLsizei height,
621                                                    GLenum format, GLenum type, ArrayBufferView? pixels);
622    [StrictTypeChecking, RaisesException] void         texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
623                                                    GLenum format, GLenum type, ImageData? pixels);
624    [StrictTypeChecking, RaisesException] void         texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
625                                                    GLenum format, GLenum type, HTMLImageElement? image);
626    [StrictTypeChecking, RaisesException] void         texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
627                                                    GLenum format, GLenum type, HTMLCanvasElement? canvas);
628#if defined(ENABLE_VIDEO) && ENABLE_VIDEO
629    [StrictTypeChecking, RaisesException] void         texSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yoffset,
630                                                    GLenum format, GLenum type, HTMLVideoElement? video);
631#endif
632
633    [StrictTypeChecking, RaisesException] void uniform1f(WebGLUniformLocation location, GLfloat x);
634    [StrictTypeChecking, Custom, RaisesException] void uniform1fv(WebGLUniformLocation location, Float32Array v);
635    [StrictTypeChecking, RaisesException] void uniform1i(WebGLUniformLocation location, GLint x);
636    [StrictTypeChecking, Custom, RaisesException] void uniform1iv(WebGLUniformLocation location, Int32Array v);
637    [StrictTypeChecking, RaisesException] void uniform2f(WebGLUniformLocation location, GLfloat x, GLfloat y);
638    [StrictTypeChecking, Custom, RaisesException] void uniform2fv(WebGLUniformLocation location, Float32Array v);
639    [StrictTypeChecking, RaisesException] void uniform2i(WebGLUniformLocation location, GLint x, GLint y);
640    [StrictTypeChecking, Custom, RaisesException] void uniform2iv(WebGLUniformLocation location, Int32Array v);
641    [StrictTypeChecking, RaisesException] void uniform3f(WebGLUniformLocation location, GLfloat x, GLfloat y, GLfloat z);
642    [StrictTypeChecking, Custom, RaisesException] void uniform3fv(WebGLUniformLocation location, Float32Array v);
643    [StrictTypeChecking, RaisesException] void uniform3i(WebGLUniformLocation location, GLint x, GLint y, GLint z);
644    [StrictTypeChecking, Custom, RaisesException] void uniform3iv(WebGLUniformLocation location, Int32Array v);
645    [StrictTypeChecking, RaisesException] void uniform4f(WebGLUniformLocation location, GLfloat x, GLfloat y, GLfloat z, GLfloat w);
646    [StrictTypeChecking, Custom, RaisesException] void uniform4fv(WebGLUniformLocation location, Float32Array v);
647    [StrictTypeChecking, RaisesException] void uniform4i(WebGLUniformLocation location, GLint x, GLint y, GLint z, GLint w);
648    [StrictTypeChecking, Custom, RaisesException] void uniform4iv(WebGLUniformLocation location, Int32Array v);
649
650    [StrictTypeChecking, Custom, RaisesException] void uniformMatrix2fv(WebGLUniformLocation location, GLboolean transpose, Float32Array array);
651    [StrictTypeChecking, Custom, RaisesException] void uniformMatrix3fv(WebGLUniformLocation location, GLboolean transpose, Float32Array array);
652    [StrictTypeChecking, Custom, RaisesException] void uniformMatrix4fv(WebGLUniformLocation location, GLboolean transpose, Float32Array array);
653
654    [StrictTypeChecking, RaisesException] void         useProgram(WebGLProgram program);
655    [StrictTypeChecking, RaisesException] void         validateProgram(WebGLProgram program);
656
657    [StrictTypeChecking] void         vertexAttrib1f(GLuint indx, GLfloat x);
658    [StrictTypeChecking, Custom] void vertexAttrib1fv(GLuint indx, Float32Array values);
659    [StrictTypeChecking] void         vertexAttrib2f(GLuint indx, GLfloat x, GLfloat y);
660    [StrictTypeChecking, Custom] void vertexAttrib2fv(GLuint indx, Float32Array values);
661    [StrictTypeChecking] void         vertexAttrib3f(GLuint indx, GLfloat x, GLfloat y, GLfloat z);
662    [StrictTypeChecking, Custom] void vertexAttrib3fv(GLuint indx, Float32Array values);
663    [StrictTypeChecking] void         vertexAttrib4f(GLuint indx, GLfloat x, GLfloat y, GLfloat z, GLfloat w);
664    [StrictTypeChecking, Custom] void vertexAttrib4fv(GLuint indx, Float32Array values);
665    [StrictTypeChecking, RaisesException] void         vertexAttribPointer(GLuint indx, GLint size, GLenum type, GLboolean normalized,
666                                                          GLsizei stride, GLintptr offset);
667
668    [StrictTypeChecking] void         viewport(GLint x, GLint y, GLsizei width, GLsizei height);
669};
670