GLES support (webGLES)

Alessandro Pignotti edited this page Jan 26, 2016 · 3 revisions

With Cheerp we ship a GLES2 implementation based on WebGL which is designed to jump start porting an existing GLES application/game to the browser.

Usage

The GLES2 API is declared in the GLES2/gl2.h header file, while webGLES specific methods are declared in the GLES2/webgles.h header. webGLES needs to be initialized using the following function

void webGLESInit(const client::String& canvasName);

which accept as the only argument the name of an existing HTML5 canvas element which should already exists at the time of webGLES initialization. An example HTML tag for such canvas:

<canvas width=1024 height=768 id="glcanvas"></canvas>

Raw WebGL access

webGLESInit creates a globally accessible WebGL context, you are free to use such context and you can mix and match between GLES and WebGL APIs. The context object is called webGLES and is accessible by including the GLES2/webgles.h header. For example:

#include <GLES2/webgles.h>
...
webGLES->createShader(GL_VERTEX_SHADER);

Helpers methods are available to convert GLES2 resources id to resource objects as used by WebGL:

client::WebGLProgram* webGLESLookupWebGLProgram(int objId);
client::WebGLShader* webGLESLookupWebGLShader(int objId);
client::WebGLBuffer* webGLESLookupWebGLBuffer(int objId);
client::WebGLFramebuffer* webGLESLookupWebGLFramebuffer(int objId);
client::WebGLRenderbuffer* webGLESLookupWebGLRenderbuffer(int objId);
client::WebGLTexture* webGLESLookupWebGLTexture(int objId);
client::WebGLUniformLocation* webGLESLookupWebGLUniformLocation(int objId);

Although webGLES implement the glTexImage2D API to load texture data, we only intend it to be used for data which is generated at run-time, like procedurally generated textures. We strongly advise using the WebGL provided texImage2D to load image data in JPEG or PNG format since the browser can decompress the images natively.

Limitations

Currently there are a few limitations:

  • glShaderSource is not supported, the native webGLES->shaderSource needs to be used
  • Various glGet* functions are not supported
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.