WebGLRenderingContext: copyTexImage2D() 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 copyTexImage2D() 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 hình ảnh kết cấu 2D.

Cú pháp

js
copyTexImage2D(target, level, internalformat, x, y, width, height, border)

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.

internalformat

Một GLenum chỉ định cách lưu trữ kết cấu sau khi nó được tải. Các giá trị có thể:

  • gl.ALPHA: Loại bỏ các thành phần màu đỏ, xanh lá cây và xanh dương và đọc thành phần alpha.
  • gl.RGB: Loại bỏ các thành phần alpha và đọc các thành phần màu đỏ, lục và lam.
  • gl.RGBA: Các thành phần màu đỏ, xanh lá cây, xanh dương và alpha được đọc từ bộ đệm màu.
  • gl.LUMINANCE: Mỗi thành phần màu là một thành phần độ chói, alpha là 1.0.
  • gl.LUMINANCE_ALPHA: Mỗi thành phần là một thành phần độ chói/alpha.
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.

border

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

Giá trị trả về

Không có (undefined).

Ví dụ

js
gl.copyTexImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 0, 0, 512, 512, 0);

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