glPolygonStipple 函式

glPolygonStipple函式會設定多邊形 Stippling 模式。

語法

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

參數

mask

32x32 Stipple 模式的指標，將會以 glDrawPixel 將 圖元解壓縮的相同方式從記憶體解壓縮。

傳回值

此函式不會傳回值。

錯誤碼

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

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

備註

glPolygonStipple函式會設定多邊形 Stippling 模式。 多邊形 stippling，例如線條 stippling (請參閱 glLineStipple) ，遮罩出點陣化所產生的特定片段，並建立模式。 Stippling 與多邊形反鋸齒無關。

mask參數是 32x32 stipple 模式的指標，儲存在記憶體中，就像高度和寬度都等於 32 的glDrawPixels、GL_COLOR_INDEX圖元格式，以及GL_BITMAP的資料類型一樣。 也就是說，存根模式會以 1 位色彩索引的 32x32 陣列表示，以未帶正負號的位元組封裝。 glPixelStore函式參數，例如GL_UNPACK_SWAP_BYTES和GL_UNPACK_LSB_FIRST，會影響位組合成 Stipple 模式。 不過，圖元傳輸作業 (位移、位移和圖元地圖) 不會套用至存根影像。

使用引數GL_POLYGON_STIPPLE，使用 glEnable 和 glDisable啟用和停用多邊形 stippling。 如果啟用，則具有視窗座標 x_w 和 y_w 的點陣化多邊形片段只有在 (x_w mod 32) 位在 (y_w mod 32) stipple 模式的第一個資料列時，才會傳送至 OpenGL 的下一個階段。 當多邊形 Stippling 停用時，就如同存根模式全都一樣。

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

glGetPolygonStipple

glIsEnabled with argument GL_POLYGON_STIPPLE

規格需求

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

另請參閱

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer