WebGLRenderingContext: scissor() 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.scissor() của WebGL API thiết lập một hộp cắt kéo, giới hạn bản vẽ trong một hình chữ nhật xác định.
Cú pháp
scissor(x, y, width, height)
Thông số
x-
A
GLintchỉ định tọa độ ngang cho phía dưới bên trái góc của hộp. Giá trị mặc định: 0. y-
A
GLintchỉ định tọa độ dọc cho góc dưới bên trái của hộp. Giá trị mặc định: 0. width-
Một
GLsizeikhông âm xác định chiều rộng của hộp cắt kéo. Giá trị mặc định: chiều rộng của khung vẽ. height-
Một
GLsizeikhông âm xác định chiều cao của hộp cắt kéo. Giá trị mặc định: chiều cao của canvas.
Giá trị trả về
Không có (undefined).
Ngoại lệ
Nếu width hoặc height là giá trị âm, lỗi gl.INVALID_VALUE sẽ được đưa ra.
Ví dụ
Khi bật tính năng kiểm tra cắt kéo, chỉ các pixel trong hộp cắt kéo mới có thể được sửa đổi bằng lệnh vẽ.
// turn on scissor test
gl.enable(gl.SCISSOR_TEST);
// set the scissor rectangle
gl.scissor(x, y, width, height);
// execute drawing commands in the scissor box (e.g. clear)
// turn off scissor test again
gl.disable(gl.SCISSOR_TEST);
Để có được kích thước hộp cắt kéo hiện tại, hãy truy vấn hằng số SCISSOR_BOX trả về Int32Array.
gl.scissor(0, 0, 200, 200);
gl.getParameter(gl.SCISSOR_BOX);
// Int32Array[0, 0, 200, 200]
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebGL Specification # 5.14.4 |