glPolygonStipple 函式

GlPolygonStipple 函數會設定多邊形 stippling 模式。

語法

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

參數

面具

32 stipple 模式的指標,會以 glDrawPixels 解壓縮圖元的相同方式從記憶體解壓縮。

傳回值

此函式不會傳回值。

錯誤碼

GlGetError函式可以取出下列錯誤碼。

Name 意義
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

GlPolygonStipple 函數會設定多邊形 stippling 模式。 多邊形 stippling,例如行 stippling (查看 glLineStipple) 、遮罩由點陣產生的特定片段,並建立模式。 Stippling 與多邊形消除鋸齒無關。

Mask 參數是 32 stipple 模式的指標,其儲存在記憶體中,就像提供給 glDrawPixels高度寬度 都等於32的圖元資料、GL 色彩索引的圖元 格式 _ _ ,以及 gl 點陣圖的資料 類型 _ 。 也就是說,stipple 模式會以非符號位元組封裝的1位色彩索引的32x32 陣列來表示。 GlPixelStore函式參數(例如 GL _ 解壓縮 _ 交換 _ 位元組和 gl _ 解壓縮 _ LSB _ )會先影響將位組合成 stipple 模式。 不過,圖元傳輸作業 (shift、offset 和圖元地圖) 不會套用至 stipple 影像。

使用引數 GL 多邊形 STIPPLE,可使用 glEnableglDisable 來啟用和停用多邊形 stippling _ _ 。 如果啟用,則只有在 (xw mod 32) 位在 stipple 模式的第一個資料列中的 (yw mod 32) 第一個資料列時,才會將具有視窗座標 xwyw的柵格化多邊形片段傳送至 OpenGL 的下一個階段。 當多邊形 stippling 停用時,就如同 stipple 模式都是一樣。

下列函式會取出與 glPolygonStipple 相關的資訊:

glGetPolygonStipple

具有引數 GL _ 多邊形 _ STIPPLE 的 glIsEnabled

規格需求

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

另請參閱

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer