WebGLRenderingContext.clear()

このロケールの翻訳が存在しないため、英語バージョンのコンテンツを表示しています。 Help us translate this article!

WebGL APIWebGLRenderingContext.clear() メソッドは、バッファーをプリセット値で消去します。

プリセット値は、clearColor(), clearDepth() や clearStencil() で設定可能です。

シザーボックス、ディザリング、バッファー書き込みマスクは clear() メソッドに影響します。

構文

void gl.clear(mask);

引数

mask
消去されるバッファーを示す GLbitfield のビット論理和マスクです。以下の値を取ることができます。
  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT

返り値

ありません。

例外

mask が記載した値のうちどれでもない場合、gl.INVALID_ENUM エラーがスローされます。

clear() メソッドは複数の値を受け入れることができます。

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 定数で問い合わせます。

gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);

仕様策定状況

仕様書 策定状況 コメント
WebGL 1.0
clear の定義
勧告 初回定義。
OpenGL ES 2.0
glClear の定義
標準 OpenGL API のマニュアルページ。

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
clearChrome 完全対応 9Edge 完全対応 12Firefox 完全対応 4IE 完全対応 11Opera 完全対応 12Safari 完全対応 5.1WebView Android 完全対応 ありChrome Android 完全対応 25Firefox Android 完全対応 ありOpera Android 完全対応 12Safari iOS 完全対応 8Samsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応

関連項目