glScissor 関数

  • [アーティクル]

glScissor 関数は、ハサミ ボックスを定義します。

構文

void WINAPI glScissor(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

パラメーター

x

ハサミ ボックスの左下隅の x (縦軸) 座標。

y

ハサミ ボックスの左下隅の y (横軸) 座標。 x と y を組み合わせて、ハサミ ボックスの左下隅を指定します。 最初は (0,0)。

width

ハサミボックスの幅。

height

ハサミボックスの高さ。 OpenGL コンテキストが 最初 にウィンドウにアタッチされると、 幅 と 高さが そのウィンドウの寸法に設定されます。

戻り値

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

エラー コード

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

名前 意味
GL_INVALID_VALUE
 幅または高さが負の値でした。
GL_INVALID_OPERATION
 この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。

解説

glScissor 関数は、ウィンドウ座標でハサミ ボックスと呼ばれる四角形を定義します。 最初の 2 つのパラメーター x と y は、ボックスの左下隅を指定します。 width パラメーターと height パラメーターは、ボックスの幅と高さを指定します。

引数GL_SCISSOR_TESTで glEnable と glDisable を使用して、ハサミ テストを有効または無効にします。 ハサミテストが有効になっている間は、ハサミボックス内にあるピクセルのみを描画コマンドで変更できます。 ウィンドウ座標はフレームバッファー ピクセルの共有コーナーに整数値を持つため、 glScisor(0,0,1,1) ではウィンドウの左下のピクセルのみを変更できます。 glScisor(0,0,0,0) は、ウィンドウ内のすべてのピクセルに対する変更を禁止します。

ハサミテストを無効にすると、ハサミボックスには窓全体が含まれているかのように見えます。

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

glGet と引数 GL_SCISSOR_BOX

glIsEnabled with argument GL_SCISSOR_TEST

必要条件

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

関連項目

glBegin

glEnable

glEnd

glIsEnabled

glViewport