WebGL2RenderingContext.compressedTexImage3D

The WebGL2RenderingContext.compressedTexImage3D() method of the WebGL API specifies a three-dimensional texture image in a compressed format.

Syntax

void gl.compressedTexImage3D(target, level, internalformat, width, height, depth, border, offset); 

void gl.compressedTexImage3D(target, level, internalformat, width, height, depth, border, ArrayBufferView srcData, optional srcOffset, optional srcLengthOverride);

Parameters

target

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

• gl.TEXTURE_3D: A three-dimensional texture.
• gl.TEXTURE_2D_ARRAY: A two-dimensional array texture.

level

A GLint specifying the level of detail. Level 0 is the base image level and level n is the nth mipmap reduction level.

internalformat

A GLenum specifying the compressed image format. Possible values:

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

width

A GLsizei specifying the width of the texture.

height

A GLsizei specifying the height of the texture.

depth

A GLsizei specifying the depth of the texture.

border

A GLint specifying the width of the border. Must be 0.

srcData

A ArrayBufferView that be used as a data store for the compressed image data in memory.

Return value

None.

Examples

gl.compressedTexImage3D(gl.TEXTURE_3D, 0, gl.COMPRESSED_R11_EAC, 512, 512, 512, 0, textureData);

Specifications

Browser compatibility

See also

• WebGLRenderingContext.compressedTexImage2D()