glScissor 函式

  • 發行項

glScissor函式會定義剪刀方塊。

語法

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

參數

x

x (垂直軸) 剪刀方塊左下角的座標。

y

剪刀方塊左下角的 y (水準軸) 座標。 一起，x 和 y 會指定剪刀方塊的左下角。 一開始 (0，0) 。

寬度

剪刀方塊的寬度。

height (高度)

剪刀方塊的高度。 當 OpenGL 內容第一 次 附加至視窗時， 寬度 和 高度 會設定為該視窗的維度。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱 意義
GL_INVALID_VALUE
 寬度或高度為負數。
GL_INVALID_OPERATION
 函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glScissor函式會在視窗座標中定義稱為剪刀方塊的矩形。 前兩個參數 x 和 y指定方塊左下角。 寬度和高度參數會指定方塊的寬度和高度。

scissor 測試是使用 glEnable 和 glDisable 搭配引數GL_SCISSOR_TEST來啟用和停用。 啟用剪刀測試時，只有位於剪刀方塊內的圖元可以透過繪圖命令修改。 視窗座標在框架緩衝區圖元的共用角落有整數值，因此 glScissor (0，0，1，1) 只允許修改視窗中的左下角圖元， 而 glScissor (0，0，0，0，0) 不允許修改視窗中的所有圖元。

停用剪刀測試時，就像剪刀方塊包含整個視窗一樣。

下列函式會擷取 與 glScissor相關的資訊：

glGet with argument 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