WebGLRenderingContext: clear() 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.clear() của WebGL API xóa bộ đệm về các giá trị đặt trước.
Các giá trị đặt trước có thể được đặt bởi clearColor(), clearDepth() hoặc clearStencil().
Hộp cắt kéo, phối màu và mặt nạ ghi đệm có thể ảnh hưởng đến phương pháp clear(). Ví dụ, nếu việc ghi vào bộ đệm bị vô hiệu hóa thông qua colorMask(), depthMask(), hoặc stencilMask(), clear() không có tác dụng lên bộ đệm tương ứng.
Cú pháp
clear(mask)
Thông số
mask-
Mặt nạ
GLbitfieldbitwise OR cho biết bộ đệm được sử dụng đã xóa. Các giá trị có thể là:gl.COLOR_BUFFER_BITgl.DEPTH_BUFFER_BITgl.STENCIL_BUFFER_BIT
Giá trị trả về
Không có (undefined).
Ngoại lệ
Nếu mask không phải là một trong các giá trị có thể được liệt kê, lỗi gl.INVALID_ENUM sẽ được đưa ra.
Ví dụ
Phương thức clear() chấp nhận nhiều giá trị.
gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
Để có được các giá trị rõ ràng hiện tại, hãy truy vấn các hằng số COLOR_CLEAR_VALUE, DEPTH_CLEAR_VALUE, và STENCIL_CLEAR_VALUE.
gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebGL Specification # 5.14.11 |