WebGLRenderingContext: bindTexture() 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 WebGLRenderingContext.bindTexture() của WebGL API liên kết một WebGLTexture nhất định với một mục tiêu (điểm liên kết).
Cú pháp
bindTexture(target, texture)
Thông số
target-
A
GLenumchỉ định điểm liên kết (đích). Các giá trị có thể:gl.TEXTURE_2D-
Một kết cấu hai chiều.
gl.TEXTURE_CUBE_MAP-
Một kết cấu được ánh xạ hình khối.
Khi sử dụng WebGL 2 context, các giá trị sau đây có sẵn bổ sung:
- gl.TEXTURE_3D
- : Một kết cấu ba chiều.
- gl.TEXTURE_2D_ARRAY
- : Kết cấu mảng hai chiều.
texture-
Một đối tượng
WebGLTextuređể liên kết. Nếunullđược thông qua, kết cấu hiện tại bị ràng buộc cho mục tiêu đã chỉ định sẽ không bị ràng buộc.
Giá trị trả về
Không có (undefined).
Ngoại lệ
Một lỗi gl.INVALID_ENUM được đưa ra nếu target không phải là gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP, gl.TEXTURE_3D, hoặc gl.TEXTURE_2D_ARRAY.
Ví dụ
Ràng buộc một kết cấu
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
Bỏ ràng buộc một kết cấu
// Unbind any texture currently bound to TEXTURE_2D
gl.bindTexture(gl.TEXTURE_2D, null);
Nhận các ràng buộc hiện tại
Để kiểm tra liên kết kết cấu hiện tại, hãy truy vấn các hằng số gl.TEXTURE_BINDING_2D hoặc gl.TEXTURE_BINDING_CUBE_MAP.
gl.getParameter(gl.TEXTURE_BINDING_2D);
Thông số kỹ thuật
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.1 |