@luma.gl/webgl2-polyfill
WebGL2 API Polyfills for WebGL1 WebGLRenderingContext
Last updated 5 years ago
by tsherif
.
MIT
·
Repository
·
Bugs
·
Original npm
·
Tarball
·
package.json
$ npm install @luma.gl/webgl2-polyfill
SYNC missed versions from
official npm registry.
@luma.gl/webgl2-polyfill
This module installs a partial set of polyfills for WebGL1 contexts, making them more API compatible with WebGL2.
- It adds WebGL2 methods to the WebGL1 context, and simply forwards the calls to WebGL1 extensions.
- It also overrides some
getParametertype calls returning default values when WebGL2 constants are used.
This way applications can use the WebGL2 API even when using WebGL1 with extensions. While you will still have to check that the extensions you need are available, using the WebGL2 API removes multiple code paths from your application and prepares your code base for WebGL2.
Usage
yarn add @luma.gl/webgl2-polyfill
import polyfillContext from '@luma.gl/webgl2-polyfill';
const gl = canvas.getContext('webgl');
polyfillContext(gl);
// New methods are now available on the context
Functions
polyfillContext(gl : WebGLRenderingContext) : WebGLRenderingContext
Installs WebGL2 polyfills on the supplied context.
Returns: the supplied context, with additional methods added (unless it was already a WebGL2RenderingContext in which case those methods were already present).
Note: Can be called multiple times and will only install the polyfills once.
Polyfill List
After polyfillContext has been called on a WebGLRenderingContext, the following WebGL2RenderingContext methods will be available on the context:
| Polyfilled Method | Uses Extension | Fallback if no extension |
|---|---|---|
gl.createVertexArray() |
OES_vertex_array_object |
throws error |
gl.deleteVertexArray() |
ignored | |
gl.bindVertexArray() |
ignored | |
gl.isVertexArray() |
ignored |
| Polyfilled Method | Uses Extension | Fallback if no extension |
|---|---|---|
gl.vertexAttribDivisor() |
ANGLE_instanced_arrays |
throws error |
gl.drawElementsInstanced() |
ignored | |
gl.drawArraysInstanced() |
ignored |
| Polyfilled Method | Uses Extension | Fallback if no extension |
|---|---|---|
gl.drawBuffers() |
WEBGL_draw_buffers |
throws error |
| Polyfilled Method | Uses Extension | Fallback if no extension |
|---|---|---|
gl.createQuery() |
EXT_disjoint_timer_query |
throws error |
gl.deleteQuery() |
ignored | |
gl.beginQuery() |
ignored | |
gl.endQuery() |
ignored | |
gl.getQuery() |
ignored | |
gl.getQueryParameter() |
ignored |
Remarks
- This module was originally created as a helper for luma.gl, but is designed to be independently usable in other projects. It has no dependencies and makes no assumptions about other modules being available.
Current Tags
- 7.4.0-alpha.2 ... beta (5 years ago)
- 7.3.2 ... latest (5 years ago)
61 Versions
- 7.3.2 ... 5 years ago
- 7.4.0-alpha.2 ... 5 years ago
- 7.3.1 ... 5 years ago
- 7.4.0-alpha.1 ... 5 years ago
- 7.3.0 ... 5 years ago
- 7.3.0-beta.4 ... 5 years ago
- 7.3.0-beta.3 ... 5 years ago
- 7.3.0-beta.2 ... 5 years ago
- 7.3.0-beta.1 ... 5 years ago
- 7.3.0-alpha.9 ... 5 years ago
- 7.3.0-alpha.8 ... 5 years ago
- 7.3.0-alpha.7 ... 5 years ago
- 7.3.0-alpha.6 ... 5 years ago
- 7.3.0-alpha.5 ... 5 years ago
- 7.3.0-alpha.4 ... 5 years ago
- 7.3.0-alpha.3 ... 5 years ago
- 7.3.0-alpha.2 ... 5 years ago
- 7.3.0-alpha.1 ... 5 years ago
- 7.2.0 ... 5 years ago
- 7.2.0-beta.1 ... 5 years ago
- 7.2.0-alpha.6 ... 5 years ago
- 7.2.0-alpha.5 ... 5 years ago
- 7.2.0-alpha.4 ... 5 years ago
- 7.2.0-alpha.3 ... 5 years ago
- 7.2.0-alpha.2 ... 5 years ago
- 7.2.0-alpha.1 ... 5 years ago
- 7.1.1 ... 5 years ago
- 7.1.0 ... 5 years ago
- 7.1.0-beta.1 ... 5 years ago
- 7.0.3 ... 5 years ago
- 7.1.0-alpha.5 ... 5 years ago
- 7.1.0-alpha.4 ... 5 years ago
- 7.1.0-alpha.3 ... 5 years ago
- 7.1.0-alpha.2 ... 5 years ago
- 7.0.2 ... 5 years ago
- 7.1.0-alpha.1 ... 6 years ago
- 7.0.1 ... 6 years ago
- 7.0.0 ... 6 years ago
- 7.0.0-rc.3 ... 6 years ago
- 7.0.0-rc.2 ... 6 years ago
- 7.0.0-rc.1 ... 6 years ago
- 7.0.0-beta.9 ... 6 years ago
- 7.0.0-beta.8 ... 6 years ago
- 7.0.0-beta.7 ... 6 years ago
- 7.0.0-beta.6 ... 6 years ago
- 7.0.0-beta.5 ... 6 years ago
- 7.0.0-beta.4 ... 6 years ago
- 7.0.0-beta.3 ... 6 years ago
- 7.0.0-beta.2 ... 6 years ago
- 7.0.0-beta.1 ... 6 years ago
- 7.0.0-alpha.25 ... 6 years ago
- 7.0.0-alpha.24 ... 6 years ago
- 7.0.0-alpha.23 ... 6 years ago
- 7.0.0-alpha.22 ... 6 years ago
- 7.0.0-alpha.19 ... 6 years ago
- 7.0.0-alpha.18 ... 6 years ago
- 7.0.0-alpha.15 ... 6 years ago
- 7.0.0-alpha.14 ... 6 years ago
- 7.0.0-alpha.13 ... 6 years ago
- 7.0.0-alpha.11 ... 6 years ago
- 7.0.0-alpha.8 ... 6 years ago
Maintainers (7)
1chandu
georgios-uber
gnavvy
ibgreen
jianh
pessimistress
tsherif
Downloads
Total
0
Today
0
This Week
0
This Month
0
Last Day
0
Last Week
0
Last Month
0
Dependencies (2)
- @babel/runtime ^7.0.0
- @luma.gl/constants 7.2.0-beta.1
Dev Dependencies (0)
None
Dependents (2)