glPolygonStipple 函数

glPolygonStipple 函数设置多边形存根模式。

语法

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

参数

mask

指向 32x32 存根模式的指针,该模式将以 glDrawPixels 解包像素的方式从内存中解包。

返回值

此函数不返回值。

错误代码

glGetError 函数可以检索以下错误代码。

名称 含义
GL_INVALID_OPERATION
在对 glBegin 的调用和 对 glEnd 的相应调用之间调用了该函数。

备注

glPolygonStipple 函数设置多边形存根模式。 多边形倾斜(如线夹 (看到 glLineStipple) ,掩盖光栅化产生的某些片段,从而创建模式。 Stippling 独立于多边形反锯齿。

掩码参数是指向内存中存储的 32x32 存根模式的指针,就像提供给高度宽度均等于 32 的 glDrawPixels 的像素数据一样,像素格式为GL_COLOR_INDEX,以及GL_BITMAP数据类型。 也就是说,存根模式表示为 32x32 的 1 位颜色索引数组,这些索引以无符号字节形式打包。 glPixelStore 函数参数(如GL_UNPACK_SWAP_BYTES和GL_UNPACK_LSB_FIRST)会影响将位组合成一个存根模式。 但是,像素传输操作 (移位、偏移量和像素图) 不应用于存根图像。

使用参数GL_POLYGON_STIPPLE启用和禁用 glEnableglDisable 的多边形存根。 如果启用,则具有窗口坐标 xwyw 的光栅化多边形片段将发送到 OpenGL 的下一阶段,前提是仅当 (xw mod 32) 位位于 (yw mod 32) stipple 模式的第 32 行中的 xw mod 32) 行为 1。 禁用多边形分隔时,就好像存根模式都是一样。

以下函数检索与 glPolygonStipple 相关的信息:

glGetPolygonStipple

glIsEnabled 与参数GL_POLYGON_STIPPLE

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Gl.h

Opengl32.lib
DLL
Opengl32.dll

另请参阅

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer