WebGLRenderingContext: compressedTexImage2D() method

Cú pháp

// WebGL 1:
compressedTexImage2D(target, level, internalformat, width, height, border, srcData)

// Additionally available in WebGL 2:
compressedTexImage2D(target, level, internalformat, width, height, border, srcData, srcOffset)
compressedTexImage2D(target, level, internalformat, width, height, border, srcData, srcOffset, srcLengthOverride)
compressedTexImage2D(target, level, internalformat, width, height, border, imageSize, offset)

Thông số

target

Một GLenum chỉ định điểm liên kết (đích) của kết cấu nén hoạt động. Các giá trị có thể:

• gl.TEXTURE_2D: Một kết cấu hai chiều.
• gl.TEXTURE_CUBE_MAP_POSITIVE_X: Mặt X dương cho kết cấu dạng khối lập phương.
• gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Mặt X âm cho kết cấu được ánh xạ hình khối.
• gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Mặt Y dương cho kết cấu dạng khối lập phương.
• gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Mặt Y âm cho kết cấu được ánh xạ hình khối.
• gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Mặt Z dương cho kết cấu dạng khối lập phương.
• gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Mặt Z âm cho kết cấu dạng khối lập phương.

level

A GLint xác định mức độ chi tiết. Cấp 0 là cấp độ hình ảnh cơ sở và cấp độ n là cấp độ giảm mipmap thứ n.

internalformat

A GLenum chỉ định định dạng ảnh nén. Các định dạng ảnh nén chỉ có sẵn thông qua WebGL2RenderingContext hoặc một số Phần mở rộng WebGL. Các giá trị có thể:

• Khi sử dụng WebGL2RenderingContext:

  • gl.GL_COMPRESSED_R11_EAC
  • gl.GL_COMPRESSED_SIGNED_R11_EAC
  • gl.GL_COMPRESSED_RG11_EAC
  • gl.GL_COMPRESSED_SIGNED_RG11_EAC
  • gl.GL_COMPRESSED_RGB8_ETC2
  • gl.GL_COMPRESSED_SRGB8_ETC2
  • gl.GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
  • gl.GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
  • gl.GL_COMPRESSED_RGBA8_ETC2_EAC
  • gl.GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC

• Khi sử dụng phần mở rộng WEBGL_compressed_texture_s3tc:

  • ext.COMPRESSED_RGB_S3TC_DXT1_EXT
  • ext.COMPRESSED_RGBA_S3TC_DXT1_EXT
  • ext.COMPRESSED_RGBA_S3TC_DXT3_EXT
  • ext.COMPRESSED_RGBA_S3TC_DXT5_EXT

• Khi sử dụng phần mở rộng WEBGL_compressed_texture_s3tc_srgb:

  • ext.COMPRESSED_SRGB_S3TC_DXT1_EXT
  • ext.COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
  • ext.COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
  • ext.COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT

• Khi sử dụng phần mở rộng WEBGL_compressed_texture_etc:

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

• Khi sử dụng phần mở rộng WEBGL_compressed_texture_pvrtc:

  • ext.COMPRESSED_RGB_PVRTC_4BPPV1_IMG
  • ext.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG
  • ext.COMPRESSED_RGB_PVRTC_2BPPV1_IMG
  • ext.COMPRESSED_RGBA_PVRTC_2BPPV1_IMG

• Khi sử dụng phần mở rộng WEBGL_compressed_texture_etc1:

  • ext.COMPRESSED_RGB_ETC1_WEBGL

• Khi sử dụng phần mở rộng WEBGL_compressed_texture_astc:

  • ext.COMPRESSED_RGBA_ASTC_4x4_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR
  • ext.COMPRESSED_RGBA_ASTC_5x4_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR
  • ext.COMPRESSED_RGBA_ASTC_5x5_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_6x5_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_6x6_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_8x5_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_8x6_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_8x8_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x5_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x6_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x6_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x10_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR
  • ext.COMPRESSED_RGBA_ASTC_12x10_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR
  • ext.COMPRESSED_RGBA_ASTC_12x12_KHR, ext.COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR

• Khi sử dụng phần mở rộng EXT_texture_compression_bptc:

  • ext.COMPRESSED_RGBA_BPTC_UNORM_EXT
  • ext.COMPRESSED_SRGB_ALPHA_BPTC_UNORM_EXT
  • ext.COMPRESSED_RGB_BPTC_SIGNED_FLOAT_EXT
  • ext.COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_EXT

• Khi sử dụng phần mở rộng EXT_texture_compression_rgtc:

  • ext.COMPRESSED_RED_RGTC1_EXT
  • ext.COMPRESSED_SIGNED_RED_RGTC1_EXT
  • ext.COMPRESSED_RED_GREEN_RGTC2_EXT
  • ext.COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT

width

Một GLsizei chỉ định chiều rộng của kết cấu bằng texels.

height

Một GLsizei xác định chiều cao của kết cấu tính bằng texels.

depth

Một GLsizei xác định độ sâu của kết cấu/số lượng kết cấu trong một TEXTURE_2D_ARRAY.

border

A GLint chỉ định độ rộng của đường viền. Phải là 0.

Nguồn kết cấu có thể được cung cấp theo một trong hai cách: từ ArrayBuffer (có thể được chia sẻ) sử dụng srcData, srcOffset, và srcLengthOverride; hoặc, trong WebGL 2, từ gl.PIXEL_UNPACK_BUFFER sử dụng imageSize và offset.

srcData

Một TypedArray hoặc DataView chứa dữ liệu kết cấu được nén.

srcOffset Optional

(chỉ WebGL 2) Một số nguyên xác định chỉ số của srcData để bắt đầu đọc từ đó. Mặc định là 0.

srcLengthOverride Optional

(chỉ WebGL 2) Một số nguyên xác định số phần tử trong srcData cần đọc. Mặc định là srcData.length - srcOffset.

imageSize

(chỉ WebGL 2) Một GLsizei xác định kích thước của dữ liệu hình ảnh theo byte.

offset

(chỉ WebGL 2) Một GLintptr chỉ định địa chỉ bắt đầu trong bộ đệm được liên kết với gl.PIXEL_UNPACK_BUFFER.

Giá trị trả về

Không có (undefined).

Ví dụ

const ext =
  gl.getExtension("WEBGL_compressed_texture_s3tc") ||
  gl.getExtension("MOZ_WEBGL_compressed_texture_s3tc") ||
  gl.getExtension("WEBKIT_WEBGL_compressed_texture_s3tc");

const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.compressedTexImage2D(
  gl.TEXTURE_2D,
  0,
  ext.COMPRESSED_RGBA_S3TC_DXT5_EXT,
  512,
  512,
  0,
  textureData,
);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);

Thông số kỹ thuật

Khả năng tương thích của trình duyệt

Xem thêm

• Sử dụng tiện ích mở rộng WebGL
• WebGLRenderingContext.getExtension()
• WebGLRenderingContext.compressedTexSubImage2D()
• WebGL2RenderingContext.compressedTexSubImage3D()
• WebGL2RenderingContext.compressedTexImage3D()
• WEBGL_compressed_texture_s3tc
• WEBGL_compressed_texture_s3tc_srgb
• WEBGL_compressed_texture_etc
• WEBGL_compressed_texture_pvrtc
• WEBGL_compressed_texture_etc1
• WEBGL_compressed_texture_astc
• EXT_texture_compression_bptc
• EXT_texture_compression_rgtc