Firefox Tomorrow

web api interface

WebGLTexture

View on MDN ↗

Available in workers

The WebGLTexture interface is part of the WebGL API and represents an opaque texture object providing storage and state for texturing operations.

WebGL textures

The WebGLTexture object does not define any methods or properties of its own and its content is not directly accessible. When working with WebGLTexture objects, the following methods of the WebGLRenderingContext are useful:

See also the WebGL tutorial on Using textures in WebGL.

WebXR opaque textures

When using WebXR layers, the XRWebGLBinding object will return instances of an opaque WebGLTexture for the color and depth/stencil attachments.

WebXR methods that return opaque WebGLTexture objects:

The WebXR opaque texture is identical to the standard WebGLTexture with the following exceptions:

  • A WebXR opaque texture is invalid outside a WebXR requestAnimationFrame() callback for its session.
  • A WebXR opaque texture is invalid until it is returned by getSubImage() or getViewSubImage().
  • A WebXR opaque texture for the color attachment contains colors with premultiplied alpha.
  • At the end of a requestAnimationFrame() callback a WebXR opaque texture is unbounded and detached from all WebGLShader objects.
  • A WebXR opaque texture behaves as though it was allocated with texStorage2D or texStorage3D, as appropriate, even when using a WebGL 1.0 context.
  • If a WebXR opaque texture calls deleteTexture(), an INVALID_OPERATION error is thrown.
  • Changes to the dimension or format of a WebXR opaque texture are not allowed. GL functions may only alter the texel values and texture parameters.

Examples

Creating a texture

const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also