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

Cú pháp

texImage3D(target, level, internalformat, width, height, depth, border, format, type, srcData)
texImage3D(target, level, internalformat, width, height, depth, border, format, type, srcData, srcOffset)
texImage3D(target, level, internalformat, width, height, depth, border, format, type, source)
texImage3D(target, level, internalformat, width, height, depth, border, 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.

internalformat

Một GLenum chỉ định cách texture sẽ được lưu trữ sau khi tải.

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.

border

Một GLint chỉ định chiều rộng của viền. Phải là 0.

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

Các giá trị internalformat, format và type phải tương thích với nhau.

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.texImage3D(
  gl.TEXTURE_3D,
  0, // level
  gl.RGBA, // internalFormat
  1, // width
  1, // height
  1, // depth
  0, // border
  gl.RGBA, // format
  gl.UNSIGNED_BYTE, // type
  new Uint8Array([0xff, 0x00, 0x00, 0x00]),
); // data

Đặc tả kỹ thuật

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

Xem thêm

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