glDrawBuffer 関数
glDrawBuffer 関数は、描画先のカラー バッファーを指定します。
構文
void WINAPI glDrawBuffer(
GLenum mode
);
パラメーター
-
mode
-
次の許容可能なシンボリック定数を使用して、最大 4 つのカラー バッファーを描画するように指定します。
値 説明 - GL_NONE
カラー バッファーは書き込まれない。 - GL_FRONT_LEFT
前面左側のカラー バッファーのみが書き込まれます。 - GL_FRONT_RIGHT
右端のカラー バッファーのみが書き込まれます。 - GL_BACK_LEFT
左に戻るカラー バッファーのみが書き込まれます。 - GL_BACK_RIGHT
バックライト カラー バッファーのみが書き込まれます。 - GL_FRONT
フロントレフトおよびフロントライトカラーバッファのみが書き込まれます。 フロント右カラー バッファーがない場合は、前面の左色バッファーのみが書き込まれます。 - GL_BACK
バックレフトおよびバックライトカラーバッファのみが書き込まれます。 右に戻るカラー バッファーがない場合は、左に戻るカラー バッファーのみが書き込まれます。 - GL_LEFT
フロントレフトおよびバックレフカラーバッファのみが書き込まれます。 バックレフト カラー バッファーがない場合は、左前のカラー バッファーのみが書き込まれます。 - GL_RIGHT
フロントライトとバックライトのカラーバッファーのみが書き込まれます。 バックライト カラー バッファーがない場合は、フロント右カラー バッファーのみが書き込まれます。 - GL_FRONT_AND_BACK
すべての前面と背面のカラー バッファー (フロントレフト、フロント右、バック左、バック右) が書き込まれます。 バック カラー バッファーがない場合は、フロントレフトおよびフロントライトカラーバッファのみが書き込まれます。 右のカラー バッファーがない場合は、フロントレフトおよびバックレフカラーバッファのみが書き込まれます。 右または背面のカラー バッファーがない場合は、フロント左側のカラー バッファーのみが書き込まれます。 - GL_AUXi
補助色バッファー i のみが書き込まれます。 i は 0 から GL_AUX_BUFFERS - 1 の間です。 (GL_AUX_BUFFERSは上限ではありません。使用可能な補助バッファーの数を照会するには glGet を使用します)。 既定値は、単一バッファー コンテキストの場合はGL_FRONTされ、ダブル バッファーコンテキストの場合はGL_BACKされます。
戻り値
この関数は値を返しません。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
| 名前 | 意味 |
|---|---|
|
mode が受け入れられた値ではありません。 |
|
モードによって示されるバッファーは存在しません。 |
|
この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。 |
解説
色がフレームバッファーに書き込まれると、 glDrawBuffer で指定されたカラー バッファーに書き込まれます。
描画に複数のカラー バッファーが選択されている場合、ブレンドまたは論理演算はカラー バッファーごとに個別に計算および適用され、各バッファーで異なる結果が生成される可能性があります。
単視コンテキストには左バッファーのみが含まれており、立体コンテキストには左バッファーと右バッファーの両方が含まれます。 同様に、単一バッファーのコンテキストにはフロント バッファーのみが含まれます。また、ダブル バッファーのコンテキストには、フロント バッファーとバック バッファーの両方が含まれます。 コンテキストは、OpenGL の初期化時に選択されます。
i = GL_AUX0 + i をGL_AUXする場合は常 にです。
次の関数は 、glDrawBuffer 関数に関連する情報を取得します。
glGet と引数 GL_DRAW_BUFFER
glGet と引数 GL_AUX_BUFFERS
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|