glClipPlane 函式

glClipPlane函式會指定要裁剪所有幾何的平面。

語法

void WINAPI glClipPlane(
         GLenum   plane,
   const GLdouble *equation
);

參數

飛機

要放置的裁剪平面。 接受格式GL_CLIP_PLANEi的符號名稱,其中 i 是介於 0 到 GL_MAX_CLIP_PLANES - 1 之間的整數。

方程式

四個雙精確度浮點值的陣列位址。 這些值會解譯為平面方程式。

傳回值

此函式不會傳回值。

錯誤碼

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

名稱 意義
GL_INVALID_ENUM
平面 不是可接受的值。
GL_INVALID_OPERATION
函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

幾何一律會針對 xyz中六平面 frustum 的界限裁剪。 glClipPlane函式允許其他平面的規格,不一定垂直于X 軸y軸或z軸,而所有幾何都會被裁剪。 最多可以指定GL_MAX_CLIP_PLANES平面,其中GL_MAX_CLIP_PLANES在所有實作中至少為六個。 因為產生的裁剪區域是已定義半空格的交集,所以一律會凸出。

glClipPlane函式會使用四個元件平面方程式來指定半空間。 當您呼叫 glClipPlane時,方程式 會由 modelview 矩陣的反轉轉換,並儲存在產生的眼球座標中。 模型檢視矩陣的後續變更不會影響預存平面方程式元件。 如果具有預存平面方程式元件的頂點座標點乘積為正數或零,則頂點與該裁剪平面有關。 否則,就會傳回。

使用 glEnableglDisable 函式來啟用和停用裁剪平面。 使用引數呼叫裁剪平面 GL_CLIP_PLANEi,其中 i 是平面編號。

根據預設,所有裁剪平面都會定義為眼球座標中 (0,0,0,0,0) ,並停用。

GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i一律是這種情況。

下列函式會擷 取 glClipPlane的相關資訊:

glGetClipPlane

glIsEnabled with argument GL_CLIP_PLANE i

規格需求

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

另請參閱

glBegin

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled