glClear 関数

glClear 関数は、事前設定された値へのバッファーをクリアします。

構文

void WINAPI glClear(
   GLbitfield mask
);

パラメーター

mask

消去するバッファーを示すマスクのビットごとの OR 演算子。 4つのマスクは次のとおりです。

値	説明
GL_COLOR_BUFFER_BIT	カラー 書き込みが現在有効になっているバッファー。
GL_DEPTH_BUFFER_BIT	深度バッファー。
GL_ACCUM_BUFFER_BIT	累積バッファー。
GL_STENCIL_BUFFER_BIT	ステンシル バッファー。

戻り値

この関数は値を返しません。

エラー コード

glGetError 関数では、次のエラー コードを取得できます。

Name	意味
GL_INVALID_VALUE	4 つの定義済みビット以外の任意のビットが マスクで設定されました。
GL_INVALID_OPERATION	glBegin の呼び出しと glEnd の対応する呼び出しの間に関数が呼び出されました。

注釈

glClear 関数は、ウィンドウのビットプレーン領域を、glClearColor、glClearIndex、glClearDepth、glClearStencil、および glClearAccum によって以前に選択された値に設定します。 glDrawBuffer を使用して一度に複数のバッファーを選択することで、複数のカラー バッファーを同時にクリアできます。

ピクセル所有権テスト、シザー テスト、ディザリング、バッファー 書き込みマスクは 、glClear の操作に影響します。 ハサミボックスは、クリアされた領域を境界にします。 glClear 関数は、アルファ関数、ブレンド関数、論理演算、ステンシル、テクスチャ マッピング、z バッファリングを無視します。

glClear 関数は、クリアするバッファーを示す複数の値のビットごとの OR である 1 つの引数 (マスク) を受け取ります。

各バッファーがクリアされる値は、そのバッファーのクリア値の設定によって異なります。

バッファーが存在しない場合、そのバッファーに送信される glClear 呼び出しは無効です。

次の関数は 、glClear に関連する情報を取得します。

引数GL_ACCUM_CLEAR_VALUEを含む glGet

引数GL_DEPTH_CLEAR_VALUEを含む glGet

引数GL_INDEX_CLEAR_VALUEを含む glGet

引数GL_COLOR_CLEAR_VALUEを含む glGet

引数GL_STENCIL_CLEAR_VALUEを含む glGet

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Gl.h
ライブラリ	Opengl32.lib
[DLL]	Opengl32.dll

こちらもご覧ください

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor