WebGL2RenderingContext: phương thức compressedTexSubImage3D()

Cú pháp

compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, imageSize, offset)

compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData)
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData, srcOffset)
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData, srcOffset, srcLengthOverride)

Tham số

target

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

• gl.TEXTURE_3D: Texture ba chiều.
• gl.TEXTURE_2D_ARRAY: Texture mảng hai chiều.

level

Một GLint chỉ định mức chi tiết. Mức 0 là mức hình ảnh cơ sở và mức n là mức giảm mipmap thứ n.

xoffset

Một GLint chỉ định offset x trong ảnh texture nén.

yoffset

Một GLint chỉ định offset y trong ảnh texture nén.

zoffset

Một GLint chỉ định offset z trong ảnh texture nén.

width

Một GLsizei chỉ định chiều rộng của texture nén tính bằng texel.

height

Một GLsizei chỉ định chiều cao của texture nén tính bằng texel.

depth

Một GLsizei chỉ định chiều sâu của texture/số lượng texture trong một TEXTURE_2D_ARRAY.

format

Một GLenum chỉ định định dạng ảnh nén. Để biết danh sách các giá trị có thể, xem WebGLRenderingContext.compressedTexImage2D().

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

srcData

Một TypedArray hoặc DataView chứa dữ liệu texture nén.

srcOffset Optional

Một số nguyên chỉ định chỉ mục của srcData để bắt đầu đọc. Mặc định là 0.

srcLengthOverride Optional

Một số nguyên chỉ định số phần tử trong srcData để đọc. Mặc định là srcData.length - srcOffset.

imageSize

Một GLsizei chỉ định kích thước của dữ liệu ảnh tính bằng byte.

offset

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ề

None (undefined).

Ví dụ

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

Đặc tả kỹ thuật

Tương thích trình duyệt

Xem thêm

• Sử dụng phần mở rộng WebGL
• WebGLRenderingContext.getExtension()
• WebGLRenderingContext.compressedTexSubImage2D()
• WebGL2RenderingContext.compressedTexImage3D()
• WEBGL_compressed_texture_s3tc
• WEBGL_compressed_texture_s3tc_srgb
• WEBGL_compressed_texture_etc
• WEBGL_compressed_texture_pvrtc
• WEBGL_compressed_texture_astc
• EXT_texture_compression_bptc
• EXT_texture_compression_rgtc