glPolygonOffset 函式

  • 發行項

glPolygonOffset函式會設定 OpenGL 用來計算深度值的縮放比例和單位。

語法

void WINAPI glPolygonOffset(
   GLfloat factor,
   GLfloat units
);

參數

因素

指定用來為每個多邊形建立可變深度位移的縮放比例。 初始值為零。

單位

指定乘以實作特定值的值，以建立常數深度位移。 初始值為 0。

傳回值

此函式不會傳回值。

錯誤碼

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

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

備註

啟用GL_POLYGON_OFFSET時，每個片段的深度值都會在從適當頂點的深度值插入之後位移。 位移的值是 factor * ？z + r *units，其中 ？z 是相對於多邊形螢幕區域的深度變更度量，而 r 是保證為指定實作產生可解析位移的最小值。 在深度測試執行之前，以及值寫入深度緩衝區之前，會先加入位移。

glPolygonOffset函式適用于轉譯隱藏線影像、將 decal 套用至表面，以及轉譯具有醒目提示邊緣的實心。

glPolygonOffset函式不會影響意見反應緩衝區中放置的深度座標。 它也不會影響選取範圍。

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

  • glGet with argument GL_POLYGON_OFFSET_FACTOR
  • glGet with argument GL_POLYGON_OFFSET_UNITS
  • glIsEnabled with argument GL_POLYGON_OFFSET_FILL
  • glIsEnabled with argument GL_POLYGON_OFFSET_LINE
  • glIsEnabled with argument GL_POLYGON_OFFSET_POINT

注意

glPolygonOffset函式僅適用于 OpenGl 1.1 版或更新版本。

規格需求

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

另請參閱

glDepthFunc

glDisable

glEnable

glGet

glIsEnabled

glLineWidth

glStencilOp

glTexEnv