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

Cú pháp

texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, srcData)
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, srcData, srcOffset)
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, source)
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, offset)

Tham số

target

Một GLenum chỉ định điểm liên kết (target) của texture đ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.

yoffset

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

zoffset

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

width

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

height

Một GLsizei chỉ định chiều cao của texture 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 cách mỗi phần tử số nguyên trong dữ liệu texel thô sẽ được hiểu là các thành phần màu.

type

Một GLenum chỉ định kích thước của mỗi phần tử số nguyên trong dữ liệu texel thô.

Nguồn texture có thể được cung cấp theo một trong ba cách: từ một ArrayBuffer (có thể chia sẻ) bằng cách sử dụng srcData và srcOffset; từ một source pixel DOM; hoặc từ gl.PIXEL_UNPACK_BUFFER bằng cách sử dụng 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.

source

Đọc từ một nguồn pixel DOM, có thể là một trong:

• ImageBitmap
• ImageData
• HTMLImageElement
• HTMLCanvasElement
• HTMLVideoElement
• OffscreenCanvas
• VideoFrame

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.texSubImage3D(
  gl.TEXTURE_3D,
  0,
  0,
  0,
  0,
  image.width,
  image.height,
  1,
  gl.RGBA,
  gl.UNSIGNED_BYTE,
  image,
);

Đặc tả kỹ thuật

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

Xem thêm

• WebGLRenderingContext.createTexture()
• WebGLRenderingContext.bindTexture()
• WebGL2RenderingContext.texImage3D()
• WebGL2RenderingContext.compressedTexImage3D()
• WebGL2RenderingContext.copyTexSubImage3D()
• WebGLRenderingContext.getTexParameter()
• OES_texture_float
• OES_texture_half_float
• EXT_sRGB
• EXT_texture_norm16