glAddSwapHintRectWIN コールバック関数は、SwapBuffers によってコピーされる四角形のセットを指定します。
構文
void WINAPI glAddSwapHintRectWIN(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
パラメーター
-
x
-
ヒント領域の四角形の左下隅の x 座標 (ウィンドウ座標)。
-
y
-
ヒント領域の四角形の左下隅の y 座標 (ウィンドウ座標)。
-
width
-
ヒント領域の四角形の幅。
-
height
-
ヒント領域の四角形の高さ。
戻り値
この関数は値を返しません。
注釈
glAddSwapHintRectWIN 関数は、フレーム間の再描画の量を減らすことでアニメーションを高速化します。 glAddSwapHintRectWIN では、SwapBuffers を呼び出すときにコピーする四角形の領域のセットを指定します。 SwapBuffers を呼び出す前に glAddSwapHintRectWIN で四角形を指定しないと、フレームバッファー全体がスワップされます。 glAddSwapHintRectWIN を使用してバッファーの変更された部分のみをコピーすると、特に SwapBuffers がソフトウェアに実装されている場合に、SwapBuffers のパフォーマンスが大幅に向上する可能性があります。
glAddSwapHintRectWIN 関数は、ヒント領域に四角形を追加します。 PIXELFORMATDESCRIPTOR ピクセル形式構造体のPFD_SWAP_COPY フラグが設定されている場合、SwapBuffers はこの領域を使用して、バック バッファーのコピーをフロント バッファーにクリップします。 PFD_SWAP_COPYは指定しません。これは、対応するハードウェアによって設定されます。 ヒント領域は、 SwapBuffers を呼び出すたびにクリアされます。 一部のハードウェア構成では、 SwapBuffers はヒント領域を無視し、バッファー全体を交換できます。 SwapBuffers は、アプリケーションではなく、システムによって実装されます。
OpenGL では、ウィンドウごとに個別のヒント領域が保持されます。 ウィンドウに関連付けられているレンダリング コンテキストで glAddSwapHintRectWIN を呼び出すと、ヒントの四角形が 1 つの領域に結合されます。
glAddSwapHintRectWIN を呼び出し、フレームに対して描画された各オブジェクトの外接する四角形と、前のフレーム オブジェクトを消去するためにクリアされた四角形ごとにを呼び出します。
Note
glAddSwapHintRectWIN 関数は、標準の OpenGL ライブラリの一部ではありませんが、GL_WIN_swap_hint拡張機能の一部である拡張関数です。 OpenGL の実装で glAddSwapHintRectWIN がサポートされているかどうかをチェックするには、glGetString(GL_EXTENSIONS) を呼び出します。 GL_WIN_swap_hintを返す場合は、 glAddSwapHintRectWIN がサポートされます。 拡張関数のアドレスを取得するには、 wglGetProcAddress を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|