WebGL2RenderingContext: texStorage2D() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

See full compatibility

Note: This feature is available in Web Workers.

The texStorage2D() method of the WebGL2RenderingContext of the WebGL API specifies all levels of two-dimensional texture storage.

Syntax

texStorage2D(target, levels, internalformat, width, height)

Parameters

target

A GLenum specifying the binding point (target) of the active texture. Possible values:

gl.TEXTURE_2D: A two-dimensional texture.
gl.TEXTURE_CUBE_MAP: A cube-mapped texture.

levels

A GLint specifying the number of texture levels.

internalformat

A GLenum specifying the texture store format. Possible values:

gl.R8
gl.R8_SNORM
gl.R16F
gl.R32F
gl.R8UI
gl.R8I
gl.R16UI
gl.R16I
gl.R32UI
gl.R32I
gl.RG8
gl.RG8_SNORM
gl.RG16F
gl.RG32F
gl.RG8UI
gl.RG8I
gl.RG16UI
gl.RG16I
gl.RG32UI
gl.RG32I
gl.RGB8
gl.SRGB8
gl.RGB565
gl.RGB8_SNORM
gl.R11F_G11F_B10F
gl.RGB9_E5
gl.RGB16F
gl.RGB32F
gl.RGB8UI
gl.RGB8I
gl.RGB16UI
gl.RGB16I
gl.RGB32UI
gl.RGB32I
gl.RGBA8
gl.SRGB8_ALPHA8
gl.RGBA8_SNORM
gl.RGB5_A1
gl.RGBA4
gl.RGB10_A2
gl.RGBA16F
gl.RGBA32F
gl.RGBA8UI
gl.RGBA8I
gl.RGB10_A2UI
gl.RGBA16UI
gl.RGBA16I
gl.RGBA32UI
gl.RGBA32I
gl.DEPTH_COMPONENT16
gl.DEPTH_COMPONENT24
gl.DEPTH_COMPONENT32F
gl.DEPTH24_STENCIL8
gl.DEPTH32F_STENCIL8

Unlike OpenGL 3.0, WebGL 2 doesn't support the following ETC2 and EAC compressed texture formats (see section 5.37 in the WebGL 2 spec). You might be able to enable them via the WEBGL_compressed_texture_etc extension, though.

gl.COMPRESSED_R11_EAC
gl.COMPRESSED_SIGNED_R11_EAC
gl.COMPRESSED_RG11_EAC
gl.COMPRESSED_SIGNED_RG11_EAC
gl.COMPRESSED_RGB8_ETC2
gl.COMPRESSED_SRGB8_ETC2
gl.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
gl.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
gl.COMPRESSED_RGBA8_ETC2_EAC
gl.COMPRESSED_SRGB8_ALPHA8_ETC2_EAC

For the description of these formats, see WebGLRenderingContext.texImage2D(). Because texStorage2D does not actually specify a buffer source, the format and type parameters are irrelevant, and can be considered to be any of the valid values corresponding to the internalformat.

width

A GLsizei specifying the width of the texture in texels.

height

A GLsizei specifying the height of the texture in texels.

Return value

None (undefined).

Examples

gl.texStorage2D(gl.TEXTURE_2D, 1, gl.RGB8, 256, 256);

Specifications

Specification
WebGL 2.0 Specification # 3.7.6

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`texStorage2D`	Chrome – Full support Chrome 56 (Release date: 2017-01-25) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 51 (Release date: 2017-01-24) footnote Full support	Opera – Full support Opera 43 (Release date: 2017-02-07) footnote Full support	Safari – Full support Safari 15 (Release date: 2021-09-20) footnote Full support	Chrome Android – Full support Chrome Android 58 (Release date: 2017-04-25) footnote Full support	Firefox for Android – Full support Firefox for Android 51 (Release date: 2017-01-24) footnote Full support	Opera Android – Full support Opera Android 43 (Release date: 2017-09-27) footnote Full support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote Full support	Samsung Internet – Full support Samsung Internet 7 (Release date: 2018-03-16) footnote Full support	WebView Android – Full support WebView Android 58 (Release date: 2017-04-25) footnote Full support	WebView on iOS – Full support WebView on iOS 15 (Release date: 2021-09-20) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support