glDepthRange 函式

  • 發行項

glDepthRange函式會指定從標準化裝置座標到視窗座標的z值對應。

語法

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

參數

zNear

接近裁剪平面與視窗座標的對應。 預設值為零。

zFar

遠裁剪平面與視窗座標的對應。 預設值為 1。

傳回值

此函式不會傳回值。

錯誤碼

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

名稱 意義
GL_INVALID_OPERATION
 函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

依 w裁剪和除法之後， z 座標範圍從 0.0 到 1.0，對應到接近和遠的裁剪平面。 glDepthRange函式會指定此範圍中正規化z座標與視窗z座標的線性對應。 不論實際的深度緩衝區實作為何，視窗座標深度值都會被視為範圍從 0.0 到 1.0 (，例如色彩元件) 。 因此， glDepthRange 接受的值在接受之前都會固定到此範圍。

(0，1) 的預設對應會將接近平面對應至 0，並將遠平面對應至 1。 使用此對應時，會完全利用深度緩衝區範圍。

zNear不一定要小於zFar。 可以接受反向對應，例如 (1，0) 。

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

glGet with argument GL_DEPTH_RANGE

規格需求

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

另請參閱

glBegin

glDepthFunc

glEnd

glGet

glViewport