WebGLRenderingContext: copyTexSubImage2D() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers.

Phương thức copyTexSubImage2D() của giao diện WebGLRenderingContext của WebGL API sao chép các pixel từ WebGLFramebuffer hiện tại thành một ảnh phụ có kết cấu 2D.

Cú pháp

js
copyTexSubImage2D(target, level, xoffset, yoffset, x, y, width, height)

Thông số

target

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

xoffset

A GLint chỉ định độ lệch ngang trong ảnh kết cấu.

yoffset

Một GLint chỉ định độ lệch dọc trong ảnh kết cấu.

x

A GLint chỉ định tọa độ x của góc dưới bên trái nơi bắt đầu sao chép.

y

A GLint chỉ định tọa độ y của góc dưới bên trái nơi bắt đầu sao chép.

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.

Giá trị trả về

Không có (undefined).

Ví dụ

js
gl.copyTexSubImage2D(gl.TEXTURE_2D, 0, 0, 0, 0, 0, 16, 16);

Thông số kỹ thuật

Thông số kỹ thuật
WebGL Specification
# 5.14.8

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

Xem thêm