84c509c14c3c8e6a6efcf7ad8a82d4aa0d1b7e76
[WebKit-https.git] / Source / Platform / chromium / public / WebGraphicsContext3D.h
1 /*
2  * Copyright (C) 2010 Google 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 are
6  * met:
7  *
8  *     * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *     * Redistributions in binary form must reproduce the above
11  * copyright notice, this list of conditions and the following disclaimer
12  * in the documentation and/or other materials provided with the
13  * distribution.
14  *     * Neither the name of Google Inc. nor the names of its
15  * contributors may be used to endorse or promote products derived from
16  * this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30
31 #ifndef WebGraphicsContext3D_h
32 #define WebGraphicsContext3D_h
33
34 #include "WebCommon.h"
35 #include "WebGraphicsMemoryAllocation.h"
36 #include "WebNonCopyable.h"
37 #include "WebString.h"
38
39 #define USE_WGC3D_TYPES
40
41 #if WEBKIT_USING_SKIA
42 struct GrGLInterface;
43 #endif
44
45 namespace WebKit {
46
47 // WGC3D types match the corresponding GL types as defined in OpenGL ES 2.0
48 // header file gl2.h from khronos.org.
49 typedef char WGC3Dchar;
50 typedef unsigned int WGC3Denum;
51 typedef unsigned char WGC3Dboolean;
52 typedef unsigned int WGC3Dbitfield;
53 typedef signed char WGC3Dbyte;
54 typedef unsigned char WGC3Dubyte;
55 typedef short WGC3Dshort;
56 typedef unsigned short WGC3Dushort;
57 typedef int WGC3Dint;
58 typedef int WGC3Dsizei;
59 typedef unsigned int WGC3Duint;
60 typedef float WGC3Dfloat;
61 typedef float WGC3Dclampf;
62 typedef signed long int WGC3Dintptr;
63 typedef signed long int WGC3Dsizeiptr;
64
65 // Typedef for server-side objects like OpenGL textures and program objects.
66 typedef WGC3Duint WebGLId;
67
68 // This interface abstracts the operations performed by the
69 // GraphicsContext3D in order to implement WebGL. Nearly all of the
70 // methods exposed on this interface map directly to entry points in
71 // the OpenGL ES 2.0 API.
72 //
73 // Creating a WebGraphicsContext does not make it current, or guarantee
74 // that the context has been created successfully. Use
75 // makeContextCurrent() to complete initialization of the context, treating
76 // a false return value as indication that the context could not be created
77 // successfully.
78 class WebGraphicsContext3D : public WebNonCopyable {
79 public:
80     // Return value from getActiveUniform and getActiveAttrib.
81     struct ActiveInfo {
82         WebString name;
83         WGC3Denum type;
84         WGC3Dint size;
85     };
86
87     // Context creation attributes.
88     struct Attributes {
89         Attributes()
90             : alpha(true)
91             , depth(true)
92             , stencil(true)
93             , antialias(true)
94             , premultipliedAlpha(true)
95             , canRecoverFromContextLoss(true)
96             , noExtensions(false)
97             , shareResources(true)
98             , preferDiscreteGPU(false)
99         {
100         }
101
102         bool alpha;
103         bool depth;
104         bool stencil;
105         bool antialias;
106         bool premultipliedAlpha;
107         bool canRecoverFromContextLoss;
108         bool noExtensions;
109         bool shareResources;
110         bool preferDiscreteGPU;
111     };
112
113     class WebGraphicsContextLostCallback {
114     public:
115         virtual void onContextLost() = 0;
116         virtual ~WebGraphicsContextLostCallback() { }
117     };
118
119     class WebGraphicsErrorMessageCallback {
120     public:
121         virtual void onErrorMessage(const WebString&, WGC3Dint) = 0;
122         virtual ~WebGraphicsErrorMessageCallback() { }
123     };
124
125     class WebGraphicsSwapBuffersCompleteCallbackCHROMIUM {
126     public:
127         virtual void onSwapBuffersComplete() = 0;
128         virtual ~WebGraphicsSwapBuffersCompleteCallbackCHROMIUM() { }
129     };
130
131     class WebGraphicsMemoryAllocationChangedCallbackCHROMIUM {
132     public:
133         // FIXME: Remove this once we switch to WebGraphicsMemoryAllocation version.
134         virtual void onMemoryAllocationChanged(size_t gpuResourceSizeInBytes) = 0;
135         // FIXME: Make this pure virtual once we implement everywhere.
136         virtual void onMemoryAllocationChanged(WebGraphicsMemoryAllocation) { }
137
138     protected:
139         virtual ~WebGraphicsMemoryAllocationChangedCallbackCHROMIUM() { }
140     };
141
142     // This destructor needs to be public so that using classes can destroy instances if initialization fails.
143     virtual ~WebGraphicsContext3D() { }
144
145     // Makes the OpenGL context current on the current thread. Returns true on
146     // success.
147     virtual bool makeContextCurrent() = 0;
148
149     // The size of the region into which this WebGraphicsContext3D is rendering.
150     // Returns the last values passed to reshape().
151     virtual int width() = 0;
152     virtual int height() = 0;
153
154     // Resizes the region into which this WebGraphicsContext3D is drawing.
155     virtual void reshape(int width, int height) = 0;
156
157     // GL_CHROMIUM_setVisibility - Changes the visibility of the backbuffer
158     virtual void setVisibilityCHROMIUM(bool visible) = 0;
159
160     // GL_CHROMIUM_gpu_memory_manager - sets callback to observe changes to memory allocation limits.
161     virtual void setMemoryAllocationChangedCallbackCHROMIUM(WebGraphicsMemoryAllocationChangedCallbackCHROMIUM* callback) { }
162
163     // Query whether it is built on top of compliant GLES2 implementation.
164     virtual bool isGLES2Compliant() = 0;
165
166     virtual bool setParentContext(WebGraphicsContext3D* parentContext) { return false; }
167
168     // Helper for software compositing path. Reads back the frame buffer into
169     // the memory region pointed to by "pixels" with size "bufferSize". It is
170     // expected that the storage for "pixels" covers (4 * width * height) bytes.
171     // Returns true on success.
172     virtual bool readBackFramebuffer(unsigned char* pixels, size_t bufferSize, WebGLId framebuffer, int width, int height) = 0;
173
174     // Returns the id of the texture which is used for storing the contents of
175     // the framebuffer associated with this context. This texture is accessible
176     // by the gpu-based page compositor.
177     virtual WebGLId getPlatformTextureId() = 0;
178
179     // Copies the contents of the off-screen render target used by the WebGL
180     // context to the corresponding texture used by the compositor.
181     virtual void prepareTexture() = 0;
182
183     // GL_CHROMIUM_post_sub_buffer - Copies part of the back buffer to the front buffer.
184     virtual void postSubBufferCHROMIUM(int x, int y, int width, int height) = 0;
185
186     // Synthesizes an OpenGL error which will be returned from a
187     // later call to getError. This is used to emulate OpenGL ES
188     // 2.0 behavior on the desktop and to enforce additional error
189     // checking mandated by WebGL.
190     //
191     // Per the behavior of glGetError, this stores at most one
192     // instance of any given error, and returns them from calls to
193     // getError in the order they were added.
194     virtual void synthesizeGLError(WGC3Denum) = 0;
195
196     virtual bool isContextLost() = 0;
197
198     // GL_CHROMIUM_map_sub
199     virtual void* mapBufferSubDataCHROMIUM(WGC3Denum target, WGC3Dintptr offset, WGC3Dsizeiptr size, WGC3Denum access) = 0;
200     virtual void unmapBufferSubDataCHROMIUM(const void*) = 0;
201     virtual void* mapTexSubImage2DCHROMIUM(WGC3Denum target, WGC3Dint level, WGC3Dint xoffset, WGC3Dint yoffset, WGC3Dsizei width, WGC3Dsizei height, WGC3Denum format, WGC3Denum type, WGC3Denum access) = 0;
202     virtual void unmapTexSubImage2DCHROMIUM(const void*) = 0;
203
204     // GL_CHROMIUM_request_extension
205     virtual WebString getRequestableExtensionsCHROMIUM() = 0;
206     virtual void requestExtensionCHROMIUM(const char*) = 0;
207
208     // GL_CHROMIUM_framebuffer_multisample
209     virtual void blitFramebufferCHROMIUM(WGC3Dint srcX0, WGC3Dint srcY0, WGC3Dint srcX1, WGC3Dint srcY1, WGC3Dint dstX0, WGC3Dint dstY0, WGC3Dint dstX1, WGC3Dint dstY1, WGC3Dbitfield mask, WGC3Denum filter) = 0;
210     virtual void renderbufferStorageMultisampleCHROMIUM(WGC3Denum target, WGC3Dsizei samples, WGC3Denum internalformat, WGC3Dsizei width, WGC3Dsizei height) = 0;
211
212     // GL_CHROMIUM_swapbuffers_complete_callback
213     virtual void setSwapBuffersCompleteCallbackCHROMIUM(WebGraphicsSwapBuffersCompleteCallbackCHROMIUM* callback) { }
214
215     // GL_CHROMIUM_rate_limit_offscreen_context
216     virtual void rateLimitOffscreenContextCHROMIUM() { }
217
218     // The entry points below map directly to the OpenGL ES 2.0 API.
219     // See: http://www.khronos.org/registry/gles/
220     // and: http://www.khronos.org/opengles/sdk/docs/man/
221     virtual void activeTexture(WGC3Denum texture) = 0;
222     virtual void attachShader(WebGLId program, WebGLId shader) = 0;
223     virtual void bindAttribLocation(WebGLId program, WGC3Duint index, const WGC3Dchar* name) = 0;
224     virtual void bindBuffer(WGC3Denum target, WebGLId buffer) = 0;
225     virtual void bindFramebuffer(WGC3Denum target, WebGLId framebuffer) = 0;
226     virtual void bindRenderbuffer(WGC3Denum target, WebGLId renderbuffer) = 0;
227     virtual void bindTexture(WGC3Denum target, WebGLId texture) = 0;
228     virtual void blendColor(WGC3Dclampf red, WGC3Dclampf green, WGC3Dclampf blue, WGC3Dclampf alpha) = 0;
229     virtual void blendEquation(WGC3Denum mode) = 0;
230     virtual void blendEquationSeparate(WGC3Denum modeRGB, WGC3Denum modeAlpha) = 0;
231     virtual void blendFunc(WGC3Denum sfactor, WGC3Denum dfactor) = 0;
232     virtual void blendFuncSeparate(WGC3Denum srcRGB, WGC3Denum dstRGB, WGC3Denum srcAlpha, WGC3Denum dstAlpha) = 0;
233
234     virtual void bufferData(WGC3Denum target, WGC3Dsizeiptr size, const void* data, WGC3Denum usage) = 0;
235     virtual void bufferSubData(WGC3Denum target, WGC3Dintptr offset, WGC3Dsizeiptr size, const void* data) = 0;
236
237     virtual WGC3Denum checkFramebufferStatus(WGC3Denum target) = 0;
238     virtual void clear(WGC3Dbitfield mask) = 0;
239     virtual void clearColor(WGC3Dclampf red, WGC3Dclampf green, WGC3Dclampf blue, WGC3Dclampf alpha) = 0;
240     virtual void clearDepth(WGC3Dclampf depth) = 0;
241     virtual void clearStencil(WGC3Dint s) = 0;
242     virtual void colorMask(WGC3Dboolean red, WGC3Dboolean green, WGC3Dboolean blue, WGC3Dboolean alpha) = 0;
243     virtual void compileShader(WebGLId shader) = 0;
244
245     virtual void compressedTexImage2D(WGC3Denum target, WGC3Dint level, WGC3Denum internalformat, WGC3Dsizei width, WGC3Dsizei height, WGC3Dint border, WGC3Dsizei imageSize, const void* data) = 0;
246     virtual void compressedTexSubImage2D(WGC3Denum target, WGC3Dint level, WGC3Dint xoffset, WGC3Dint yoffset, WGC3Dsizei width, WGC3Dsizei height, WGC3Denum format, WGC3Dsizei imageSize, const void* data) = 0;
247     virtual void copyTexImage2D(WGC3Denum target, WGC3Dint level, WGC3Denum internalformat, WGC3Dint x, WGC3Dint y, WGC3Dsizei width, WGC3Dsizei height, WGC3Dint border) = 0;
248     virtual void copyTexSubImage2D(WGC3Denum target, WGC3Dint level, WGC3Dint xoffset, WGC3Dint yoffset, WGC3Dint x, WGC3Dint y, WGC3Dsizei width, WGC3Dsizei height) = 0;
249     virtual void cullFace(WGC3Denum mode) = 0;
250     virtual void depthFunc(WGC3Denum func) = 0;
251     virtual void depthMask(WGC3Dboolean flag) = 0;
252     virtual void depthRange(WGC3Dclampf zNear, WGC3Dclampf zFar) = 0;
253     virtual void detachShader(WebGLId program, WebGLId shader) = 0;
254     virtual void disable(WGC3Denum cap) = 0;
255     virtual void disableVertexAttribArray(WGC3Duint index) = 0;
256     virtual void drawArrays(WGC3Denum mode, WGC3Dint first, WGC3Dsizei count) = 0;
257     virtual void drawElements(WGC3Denum mode, WGC3Dsizei count, WGC3Denum type, WGC3Dintptr offset) = 0;
258
259     virtual void enable(WGC3Denum cap) = 0;
260     virtual void enableVertexAttribArray(WGC3Duint index) = 0;
261     virtual void finish() = 0;
262     virtual void flush() = 0;
263     virtual void framebufferRenderbuffer(WGC3Denum target, WGC3Denum attachment, WGC3Denum renderbuffertarget, WebGLId renderbuffer) = 0;
264     virtual void framebufferTexture2D(WGC3Denum target, WGC3Denum attachment, WGC3Denum textarget, WebGLId texture, WGC3Dint level) = 0;
265     virtual void frontFace(WGC3Denum mode) = 0;
266     virtual void generateMipmap(WGC3Denum target) = 0;
267
268     virtual bool getActiveAttrib(WebGLId program, WGC3Duint index, ActiveInfo&) = 0;
269     virtual bool getActiveUniform(WebGLId program, WGC3Duint index, ActiveInfo&) = 0;
270     virtual void getAttachedShaders(WebGLId program, WGC3Dsizei maxCount, WGC3Dsizei* count, WebGLId* shaders) = 0;
271     virtual WGC3Dint getAttribLocation(WebGLId program, const WGC3Dchar* name) = 0;
272     virtual void getBooleanv(WGC3Denum pname, WGC3Dboolean* value) = 0;
273     virtual void getBufferParameteriv(WGC3Denum target, WGC3Denum pname, WGC3Dint* value) = 0;
274     virtual Attributes getContextAttributes() = 0;
275     virtual WGC3Denum getError() = 0;
276     virtual void getFloatv(WGC3Denum pname, WGC3Dfloat* value) = 0;
277     virtual void getFramebufferAttachmentParameteriv(WGC3Denum target, WGC3Denum attachment, WGC3Denum pname, WGC3Dint* value) = 0;
278     virtual void getIntegerv(WGC3Denum pname, WGC3Dint* value) = 0;
279     virtual void getProgramiv(WebGLId program, WGC3Denum pname, WGC3Dint* value) = 0;
280     virtual WebString getProgramInfoLog(WebGLId program) = 0;
281     virtual void getRenderbufferParameteriv(WGC3Denum target, WGC3Denum pname, WGC3Dint* value) = 0;
282     virtual void getShaderiv(WebGLId shader, WGC3Denum pname, WGC3Dint* value) = 0;
283     virtual WebString getShaderInfoLog(WebGLId shader) = 0;
284
285     // TBD
286     // void glGetShaderPrecisionFormat (GLenum shadertype, GLenum precisiontype, GLint* range, GLint* precision);
287
288     virtual WebString getShaderSource(WebGLId shader) = 0;
289     virtual WebString getString(WGC3Denum name) = 0;
290     virtual void getTexParameterfv(WGC3Denum target, WGC3Denum pname, WGC3Dfloat* value) = 0;
291     virtual void getTexParameteriv(WGC3Denum target, WGC3Denum pname, WGC3Dint* value) = 0;
292     virtual void getUniformfv(WebGLId program, WGC3Dint location, WGC3Dfloat* value) = 0;
293     virtual void getUniformiv(WebGLId program, WGC3Dint location, WGC3Dint* value) = 0;
294     virtual WGC3Dint getUniformLocation(WebGLId program, const WGC3Dchar* name) = 0;
295     virtual void getVertexAttribfv(WGC3Duint index, WGC3Denum pname, WGC3Dfloat* value) = 0;
296     virtual void getVertexAttribiv(WGC3Duint index, WGC3Denum pname, WGC3Dint* value) = 0;
297     virtual WGC3Dsizeiptr getVertexAttribOffset(WGC3Duint index, WGC3Denum pname) = 0;
298
299     virtual void hint(WGC3Denum target, WGC3Denum mode) = 0;
300     virtual WGC3Dboolean isBuffer(WebGLId buffer) = 0;
301     virtual WGC3Dboolean isEnabled(WGC3Denum cap) = 0;
302     virtual WGC3Dboolean isFramebuffer(WebGLId framebuffer) = 0;
303     virtual WGC3Dboolean isProgram(WebGLId program) = 0;
304     virtual WGC3Dboolean isRenderbuffer(WebGLId renderbuffer) = 0;
305     virtual WGC3Dboolean isShader(WebGLId shader) = 0;
306     virtual WGC3Dboolean isTexture(WebGLId texture) = 0;
307     virtual void lineWidth(WGC3Dfloat) = 0;
308     virtual void linkProgram(WebGLId program) = 0;
309     virtual void pixelStorei(WGC3Denum pname, WGC3Dint param) = 0;
310     virtual void polygonOffset(WGC3Dfloat factor, WGC3Dfloat units) = 0;
311
312     virtual void readPixels(WGC3Dint x, WGC3Dint y, WGC3Dsizei width, WGC3Dsizei height, WGC3Denum format, WGC3Denum type, void* pixels) = 0;
313
314     virtual void releaseShaderCompiler() = 0;
315
316     virtual void renderbufferStorage(WGC3Denum target, WGC3Denum internalformat, WGC3Dsizei width, WGC3Dsizei height) = 0;
317     virtual void sampleCoverage(WGC3Dclampf value, WGC3Dboolean invert) = 0;
318     virtual void scissor(WGC3Dint x, WGC3Dint y, WGC3Dsizei width, WGC3Dsizei height) = 0;
319     virtual void shaderSource(WebGLId shader, const WGC3Dchar* string) = 0;
320     virtual void stencilFunc(WGC3Denum func, WGC3Dint ref, WGC3Duint mask) = 0;
321     virtual void stencilFuncSeparate(WGC3Denum face, WGC3Denum func, WGC3Dint ref, WGC3Duint mask) = 0;
322     virtual void stencilMask(WGC3Duint mask) = 0;
323     virtual void stencilMaskSeparate(WGC3Denum face, WGC3Duint mask) = 0;
324     virtual void stencilOp(WGC3Denum fail, WGC3Denum zfail, WGC3Denum zpass) = 0;
325     virtual void stencilOpSeparate(WGC3Denum face, WGC3Denum fail, WGC3Denum zfail, WGC3Denum zpass) = 0;
326
327     virtual void texImage2D(WGC3Denum target, WGC3Dint level, WGC3Denum internalformat, WGC3Dsizei width, WGC3Dsizei height, WGC3Dint border, WGC3Denum format, WGC3Denum type, const void* pixels) = 0;
328
329     virtual void texParameterf(WGC3Denum target, WGC3Denum pname, WGC3Dfloat param) = 0;
330     virtual void texParameteri(WGC3Denum target, WGC3Denum pname, WGC3Dint param) = 0;
331
332     virtual void texSubImage2D(WGC3Denum target, WGC3Dint level, WGC3Dint xoffset, WGC3Dint yoffset, WGC3Dsizei width, WGC3Dsizei height, WGC3Denum format, WGC3Denum type, const void* pixels) = 0;
333
334     virtual void uniform1f(WGC3Dint location, WGC3Dfloat x) = 0;
335     virtual void uniform1fv(WGC3Dint location, WGC3Dsizei count, const WGC3Dfloat* v) = 0;
336     virtual void uniform1i(WGC3Dint location, WGC3Dint x) = 0;
337     virtual void uniform1iv(WGC3Dint location, WGC3Dsizei count, const WGC3Dint* v) = 0;
338     virtual void uniform2f(WGC3Dint location, WGC3Dfloat x, WGC3Dfloat y) = 0;
339     virtual void uniform2fv(WGC3Dint location, WGC3Dsizei count, const WGC3Dfloat* v) = 0;
340     virtual void uniform2i(WGC3Dint location, WGC3Dint x, WGC3Dint y) = 0;
341     virtual void uniform2iv(WGC3Dint location, WGC3Dsizei count, const WGC3Dint* v) = 0;
342     virtual void uniform3f(WGC3Dint location, WGC3Dfloat x, WGC3Dfloat y, WGC3Dfloat z) = 0;
343     virtual void uniform3fv(WGC3Dint location, WGC3Dsizei count, const WGC3Dfloat* v) = 0;
344     virtual void uniform3i(WGC3Dint location, WGC3Dint x, WGC3Dint y, WGC3Dint z) = 0;
345     virtual void uniform3iv(WGC3Dint location, WGC3Dsizei count, const WGC3Dint* v) = 0;
346     virtual void uniform4f(WGC3Dint location, WGC3Dfloat x, WGC3Dfloat y, WGC3Dfloat z, WGC3Dfloat w) = 0;
347     virtual void uniform4fv(WGC3Dint location, WGC3Dsizei count, const WGC3Dfloat* v) = 0;
348     virtual void uniform4i(WGC3Dint location, WGC3Dint x, WGC3Dint y, WGC3Dint z, WGC3Dint w) = 0;
349     virtual void uniform4iv(WGC3Dint location, WGC3Dsizei count, const WGC3Dint* v) = 0;
350     virtual void uniformMatrix2fv(WGC3Dint location, WGC3Dsizei count, WGC3Dboolean transpose, const WGC3Dfloat* value) = 0;
351     virtual void uniformMatrix3fv(WGC3Dint location, WGC3Dsizei count, WGC3Dboolean transpose, const WGC3Dfloat* value) = 0;
352     virtual void uniformMatrix4fv(WGC3Dint location, WGC3Dsizei count, WGC3Dboolean transpose, const WGC3Dfloat* value) = 0;
353
354     virtual void useProgram(WebGLId program) = 0;
355     virtual void validateProgram(WebGLId program) = 0;
356
357     virtual void vertexAttrib1f(WGC3Duint index, WGC3Dfloat x) = 0;
358     virtual void vertexAttrib1fv(WGC3Duint index, const WGC3Dfloat* values) = 0;
359     virtual void vertexAttrib2f(WGC3Duint index, WGC3Dfloat x, WGC3Dfloat y) = 0;
360     virtual void vertexAttrib2fv(WGC3Duint index, const WGC3Dfloat* values) = 0;
361     virtual void vertexAttrib3f(WGC3Duint index, WGC3Dfloat x, WGC3Dfloat y, WGC3Dfloat z) = 0;
362     virtual void vertexAttrib3fv(WGC3Duint index, const WGC3Dfloat* values) = 0;
363     virtual void vertexAttrib4f(WGC3Duint index, WGC3Dfloat x, WGC3Dfloat y, WGC3Dfloat z, WGC3Dfloat w) = 0;
364     virtual void vertexAttrib4fv(WGC3Duint index, const WGC3Dfloat* values) = 0;
365     virtual void vertexAttribPointer(WGC3Duint index, WGC3Dint size, WGC3Denum type, WGC3Dboolean normalized,
366                                      WGC3Dsizei stride, WGC3Dintptr offset) = 0;
367
368     virtual void viewport(WGC3Dint x, WGC3Dint y, WGC3Dsizei width, WGC3Dsizei height) = 0;
369
370     // Support for buffer creation and deletion.
371     virtual WebGLId createBuffer() = 0;
372     virtual WebGLId createFramebuffer() = 0;
373     virtual WebGLId createProgram() = 0;
374     virtual WebGLId createRenderbuffer() = 0;
375     virtual WebGLId createShader(WGC3Denum) = 0;
376     virtual WebGLId createTexture() = 0;
377
378     virtual void deleteBuffer(WebGLId) = 0;
379     virtual void deleteFramebuffer(WebGLId) = 0;
380     virtual void deleteProgram(WebGLId) = 0;
381     virtual void deleteRenderbuffer(WebGLId) = 0;
382     virtual void deleteShader(WebGLId) = 0;
383     virtual void deleteTexture(WebGLId) = 0;
384
385     virtual void setContextLostCallback(WebGraphicsContextLostCallback* callback) { }
386     virtual void setErrorMessageCallback(WebGraphicsErrorMessageCallback* callback) { }
387     // GL_ARB_robustness
388     //
389     // This entry point must provide slightly different semantics than
390     // the GL_ARB_robustness extension; specifically, the lost context
391     // state is sticky, rather than reported only once.
392     virtual WGC3Denum getGraphicsResetStatusARB() { return 0; /* GL_NO_ERROR */ }
393
394     // FIXME: make this function pure virtual once it is implemented in
395     // both command buffer port and in-process port.
396     virtual WebString getTranslatedShaderSourceANGLE(WebGLId shader) { return WebString(); }
397
398     // GL_CHROMIUM_iosurface
399     virtual void texImageIOSurface2DCHROMIUM(WGC3Denum target, WGC3Dint width, WGC3Dint height, WGC3Duint ioSurfaceId, WGC3Duint plane) { }
400
401     // GL_EXT_texture_storage
402     virtual void texStorage2DEXT(WGC3Denum target, WGC3Dint levels, WGC3Duint internalformat,
403                                  WGC3Dint width, WGC3Dint height) { }
404
405     // GL_EXT_occlusion_query
406     virtual WebGLId createQueryEXT() = 0;
407     virtual void deleteQueryEXT(WebGLId query) = 0;
408     virtual WGC3Dboolean isQueryEXT(WebGLId query) = 0;
409     virtual void beginQueryEXT(WGC3Denum target, WebGLId query) = 0;
410     virtual void endQueryEXT(WGC3Denum target) = 0;
411     virtual void getQueryivEXT(WGC3Denum target, WGC3Denum pname, WGC3Dint* params) = 0;
412     virtual void getQueryObjectuivEXT(WebGLId query, WGC3Denum pname, WGC3Duint* params) = 0;
413
414 #if WEBKIT_USING_SKIA
415     GrGLInterface* createGrGLInterface();
416 #endif
417
418 protected:
419 #if WEBKIT_USING_SKIA
420     virtual GrGLInterface* onCreateGrGLInterface() { return 0; }
421 #endif
422
423 };
424
425 } // namespace WebKit
426
427 #endif