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⁩.

Note: This feature is available inWeb Workers.

ThetexStorage2D() method of theWebGL2RenderingContext of theWebGL API specifies all levels of two-dimensional texture storage.

Syntax

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

Parameters

target

AGLenum 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

AGLint specifying the number of texture levels.

internalformat

AGLenum 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 2doesn't support the following ETC2 and EAC compressed texture formats (seesection 5.37 in the WebGL 2 spec). You might be able to enable them via theWEBGL_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, seeWebGLRenderingContext.texImage2D(). BecausetexStorage2D does not actually specify a buffer source, theformat andtype parameters are irrelevant, and can be considered to be any of the valid values corresponding to theinternalformat.

width

AGLsizei specifying the width of the texture in texels.

height

AGLsizei 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

Help improve MDN

Learn how to contribute

This page was last modified on⁨Aug 27, 2025⁩ byMDN contributors.

View this page on GitHub •Report a problem with this content

Movatterモバイル変換