WebGLRenderingContext.clear()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
WebGL API の WebGLRenderingContext.clear() メソッドは、バッファーをプリセット値で消去します。
プリセット値は、clearColor(), clearDepth() や clearStencil() で設定可能です。
シザーボックス、ディザリング、バッファー書き込みマスクは clear() メソッドに影響します。
構文
void gl.clear(mask);
引数
mask-
消去されるバッファーを示す
GLbitfieldのビット論理和マスクです。以下の値を取ることができます。gl.COLOR_BUFFER_BITgl.DEPTH_BUFFER_BITgl.STENCIL_BUFFER_BIT
返り値
ありません。
例外
mask が記載した値のうちどれでもない場合、gl.INVALID_ENUM エラーがスローされます。
例
clear() メソッドは複数の値を受け入れることができます。
js
gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
現在の消去する値を取得するには、COLOR_CLEAR_VALUE, DEPTH_CLEAR_VALUE, や STENCIL_CLEAR_VALUE 定数で問い合わせます。
js
gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);
仕様書
| 仕様書 |
|---|
| WebGL Specification # 5.14.11 |