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函式可以取出下列錯誤碼。

Name 意義
GL _ 無效 _ 值
寬度高度 都是負數。
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

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

使用 glEnableglDisable 搭配引數 GL 剪下測試,可啟用和停用剪式測試 _ _ 。 當剪下測試啟用時,繪製命令只能修改位於剪下方塊內的圖元。 視窗座標在畫面格緩衝區圖元的共用角落具有整數值,因此 glScissor (0、0、1、1) 只允許修改視窗中的左下圖元,而 glScissor (0、0、0、0) 不允許修改視窗中的所有圖元。

當剪式測試停用時,就如同剪下方塊包含整個視窗一樣。

下列函式會取出與 glScissor 相關的資訊:

具有引數 GL _ 剪狀方塊的 glGet _

具有引數 GL _ 剪式測試的 glIsEnabled _

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Gl
程式庫
Opengl32 .lib
DLL
Opengl32.dll

另請參閱

glBegin

glEnable

glEnd

glIsEnabled

glViewport