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