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的對應呼叫之間呼叫。

備註

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

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

使用 glEnable 和 glDisable 函式來啟用和停用裁剪平面。 使用引數呼叫裁剪平面 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