Creating a render window. The EGL specification does not specify how a target window is created to which to render to. One must use platform-specific native window system functions (X11, Win32 API, ANativeWindow) to first create a render window.

Specifying render window size in arbitrary pixel increments. EGL does not have any functionality to request a desired size for the main render window, or to resize it.

Specifying a fullscreen video mode/screen resolution. EGL cannot be used to control whether to render in a windowed or fullscreen mode, or to toggle between these at runtime.

Obtain a handle to an EGLDisplay object by calling eglGetDisplay .

Initialize EGL on that display by calling eglInitialize .

Call eglGetConfigs and/or eglChooseConfig one or multiple times to find the EGLConfig that represents the desired main render target parameters. To examine the attributes of an EGLConfig , call eglGetConfigAttrib .

At this point, one would use whatever platform-specific functions available ( X11 , Win32 API , ANativeWindow ) to set up a native window to render to. For Emscripten, this step does not apply, and can be skipped.

Create a main render target surface ( EGLSurface ) by calling eglCreateWindowSurface with a valid display and config parameters. Set window and attribute list parameters to null.

Create a GLES2 rendering context ( EGLContext ) by calling eglCreateContext , followed by a call to eglMakeCurrent to activate the rendering context. When creating the context, specify the context attribute EGL_CONTEXT_CLIENT_VERSION == 2 .

Free up the currently active rendering context by calling eglMakeCurrent(display, EGL_NO_SURFACE, EGL_NO_SURFACE, EGL_NO_CONTEXT) .

Deinitialize the EGLContext object by calling eglDestroyContext on it.

Destroy all initialized EGLSurface objects by calling eglDestroySurface on them.

Deinitialize EGL altogether by calling eglTerminate(display) .

Delete the native rendering window. This step does not apply for Emscripten.

eglInitialize , eglGetConfigs , eglQueryContext , eglQueryString , eglQuerySurface , eglGetCurrentContext , glGetCurrentSurface , eglGetCurrentDisplay , eglReleaseThread , eglDestroySurface , eglDestroyContext : Implemented and should work according to the EGL v1.4 specification.

eglSwapBuffers : Implemented, but this function cannot really control the swap behavior under WebGL. Calling this function is optional under Emscripten. In WebGL, the contents of the display are always presented to the screen only after the code yields its execution back to the browser, that is, when you return from the tick callback handler you passed to emscripten_set_main_loop() . The eglSwapBuffers function can however still be used to detect when a GL context loss event occurs.

eglGetDisplay : Implemented according to the specification. Emscripten does not utilize multiple EGLNativeDisplayType objects, so pass in EGL_DEFAULT_DISPLAY here. Emscripten currently actually ignores any value passed in here for Linux emulation purposes, but you should not rely on this in the future.

eglGetError : Implemented according to the specification.

Important

According to the specification, eglGetError reports the single most recent error rather than the list of all previous errors. Don’t call this function in a loop in the same way you would call glGetError .

Partially implemented ¶

eglChooseConfig : Implemented as a stub, but this function does not do searching/filtering, and is at the moment identical to eglGetConfigs ( issue #643 ).

eglGetConfigAttrib : Implemented. Querying for the attributes EGL_BUFFER_SIZE , EGL_ALPHA_SIZE , EGL_BLUE_SIZE , EGL_GREEN_SIZE , EGL_RED_SIZE , EGL_DEPTH_SIZE and EGL_STENCIL_SIZE currently return hardcoded default values ( issue #644 ). The attributes EGL_MIN_SWAP_INTERVAL and EGL_MAX_SWAP_INTERVAL don’t currently have any function. Instead, call emscripten_set_main_loop() to specify the main loop update rate.

eglCreateWindowSurface : Implemented, except it is not possible to call this function multiple times to create multiple render windows.

eglCreateContext : Implemented as a stub. It is not possible to call this function multiple times to create multiple contexts.

eglBindAPI , eglQueryAPI : Implemented, although these functions have little utility on Emscripten, since only the GLES2 client API is supported.

eglWaitClient , eglWaitNative : Implemented as no-op functions. These have no meaning on Emscripten.

eglSwapInterval : Implemented as a no-op stub. Currently this function cannot set the vsync interval, or enable/disable it.

eglMakeCurrent : Implemented as a no-op stub.

eglTerminate : Implemented as a no-op function stub. JavaScript apps are not often shut down manually, but when closing the browser or switching the web page, the browser manages all teardown automatically. Therefore this function does not have a critical importance in Emscripten.

eglGetProcAddress : Implemented, experimental.

eglCreatePbufferSurface , eglCreatePixmapSurface , eglCreatePbufferFromClientBuffer , eglSurfaceAttrib , eglBindTexImage , eglReleaseTexImage , eglWaitGL , eglCopyBuffers .