glPolygonMode 函式

glPolygonMode函式會選取多邊形點陣化模式。

語法

void WINAPI glPolygonMode(
   GLenum face,
   GLenum mode
);

參數

臉

套用模式的多邊形。 必須為正面多邊形GL_FRONT，GL_BACK面向後端多邊形，或針對正面和後端多邊形GL_FRONT_AND_BACK。

mode

多邊形的點陣化方式。 下列模式已定義，而且可以在 模式中指定。 前方和後向多邊形的預設值為 GL_FILL。

值	意義
GL_POINT	標示為界限邊緣開頭的多邊形頂點會繪製為點。 點屬性，例如GL_POINT_SIZE和GL_POINT_SMOOTH控制點的點陣化。 GL_POLYGON_MODE以外的多邊形點陣化屬性沒有任何作用。
GL_LINE	多邊形的界限邊緣會繪製為線條線段。 它們會被視為線條 Stippling 的連線線段;線段之間不會重設線條 Stipple 計數器和模式， (請參閱 glLineStipple) 。 線條屬性，例如GL_LINE_WIDTH和GL_LINE_SMOOTH控制線條的點陣化。 GL_POLYGON_MODE以外的多邊形點陣化屬性沒有任何作用。
GL_FILL	多邊形的內部已填滿。 多邊形屬性，例如GL_POLYGON_STIPPLE和GL_POLYGON_SMOOTH控制多邊形的點陣化。

傳回值

此函式不會傳回值。

錯誤碼

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

名稱	意義
GL_INVALID_ENUM	臉部或模式不是接受的值。
GL_INVALID_OPERATION	在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

備註

glPolygonMode函式會控制點陣化的多邊形解譯。 臉部參數描述哪些多邊形模式適用于：正面多邊形 (GL_FRONT) 、反向多邊形 (GL_BACK) 或兩者 (GL_FRONT_AND_BACK) 。 多邊形模式只會影響多邊形的最終點陣化。 特別是，多邊形的頂點會被點選，而且多邊形會在套用這些模式之前進行裁剪，而且可能先加以擷取。

若要繪製具有填滿背面多邊形和外框的正面多邊形的介面，請呼叫

glPolygonMode (GL_FRONT，GL_LINE) ;

頂點會以邊緣旗標標示為界限或非界限。 當 Edge 旗標分解多邊形時，OpenGL 會在內部產生，而且可以使用 glEdgeFlag明確設定它們。

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

glGet with argument GL_POLYGON_MODE

規格需求

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

另請參閱

glBegin

glEdgeFlag

glEnd

glLineStipple

glLineWidth

glPointSize

glPolygonStipple