glReadBuffer 関数

  • [アーティクル]

glReadBuffer 関数は、ピクセルのカラー バッファー ソースを選択します。

構文

void WINAPI glReadBuffer(
   GLenum mode
);

パラメーター

mode

カラー バッファー。 受け入れられる値は、GL_FRONT_LEFT、GL_FRONT_RIGHT、GL_BACK_LEFT、GL_BACK_RIGHT、GL_FRONT、GL_BACK、GL_LEFT、GL_RIGHT、GL_AUX i で、 i は 0 からGL_AUX_BUFFERS 1 の間です。

戻り値

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

エラー コード

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

名前 意味
GL_INVALID_ENUM
 mode は、12 個 (またはそれ以上) で受け入れられる値の 1 つではありません。
GL_INVALID_OPERATION
 モード では、存在しないバッファーが指定されました。
GL_INVALID_OPERATION
 この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。

解説

glReadBuffer 関数は、後続の glReadPixels および glCopyPixels コマンドのソースとしてカラー バッファーを指定します。 mode パラメーターは、12 個以上の定義済みの値のいずれかを受け入れます。 (GL_AUX3を介したGL_AUX0は常に定義されます。完全に構成されたシステムでは、GL_FRONT、GL_LEFT、GL_FRONT_LEFT、すべてフロントレフト バッファーに名前を付け、GL_FRONT_RIGHTとGL_RIGHTにフロント右バッファーに名前を付け、GL_BACK_LEFTして、バックエンド バッファーに名前を付GL_BACK。

非stereo のダブル バッファー構成には、フロントレフトバッファーとバックレフトバッファのみが含まれます。 単一バッファー構成には、ステレオの場合はフロントレフトとフロントライトバッファー、非ステレオの場合はフロントレフトバッファのみが含まれます。 glReadBuffer に存在しないバッファーを指定するのはエラーです。

既定では、 モード は単一バッファー構成でGL_FRONTされ、ダブル バッファー構成ではGL_BACKされます。

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

引数GL_READ_BUFFERを含む glGet

必要条件

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

関連項目

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels