WebGLRenderingContext: activeTexture() 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.activeTexture() của WebGL API chỉ định đơn vị kết cấu nào sẽ được kích hoạt.
Cú pháp
activeTexture(texture)
Thông số
texture-
Đơn vị kết cấu để kích hoạt. Giá trị là
gl.TEXTUREItrong đó I nằm trong khoảng từ 0 tớigl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1.
Giá trị trả về
Không có (undefined).
Ngoại lệ
Nếu texture không phải là một trong gl.TEXTUREI, trong đó I nằm trong phạm vi từ 0 đến gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1, lỗi gl.INVALID_ENUM sẽ được đưa ra.
Ví dụ
Lệnh gọi sau đây chọn gl.TEXTURE1 làm kết cấu hiện tại. Các lệnh gọi tiếp theo sửa đổi trạng thái kết cấu sẽ ảnh hưởng đến kết cấu này.
gl.activeTexture(gl.TEXTURE1);
Số lượng đơn vị kết cấu phụ thuộc vào việc triển khai, bạn có thể lấy con số này với sự trợ giúp của hằng số MAX_COMBINED_TEXTURE_IMAGE_UNITS. Theo đặc điểm kỹ thuật, ít nhất là 8.
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
Để có được kết cấu hoạt động, hãy truy vấn hằng số ACTIVE_TEXTURE.
gl.activeTexture(gl.TEXTURE0);
gl.getParameter(gl.ACTIVE_TEXTURE);
// returns "33984" (0x84C0, gl.TEXTURE0 enum value)
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebGL Specification # 5.14.3 |