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 関数では、次のエラー コードを取得できます。
| 名前 | 意味 |
|---|---|
|
mode は、12 個 (またはそれ以上) で受け入れられる値の 1 つではありません。 |
|
モード では、存在しないバッファーが指定されました。 |
|
この関数は、 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 [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|