glPolygonStipple 函数

glPolygonStipple 函数设置多边形安装模式。

语法

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

参数

mask

指向 32x32 点模式的指针，该模式将从内存中解包，其方式与 glDrawPixel 解包像素的方式相同。

返回值

此函数不返回值。

错误代码

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

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

备注

glPolygonStipple 函数设置多边形安装模式。 多边形截断，就像行段 (glLineStipple) 一样，会屏蔽光栅化产生的某些片段，从而创建模式。 Stippling 独立于多边形抗锯齿。

mask 参数是指向存储在内存中的 32x32 定点模式的指针，就像提供给高度和宽度均等于 32 的 glDrawPixel 的像素数据一样，像素格式为 GL_COLOR_INDEX，数据类型为 GL_BITMAP。 也就是说，点数模式表示为一个 32x32 数组，其中 1 位颜色索引打包在无符号字节中。 glPixelStore 函数参数（如 GL_UNPACK_SWAP_BYTES 和 GL_UNPACK_LSB_FIRST）会影响将位组合成存点模式。 但是， (偏移、偏移和像素贴图) 的像素传输操作不会应用于定点图像。

使用参数GL_POLYGON_STIPPLE启用和禁用 glEnable 和 glDisable 的多边形安装。 如果启用，则仅当 (x_wmod 32) (y_w mod 32) 第 (行为 1 时，才会将具有窗口坐标 x w 和 y_{w w} 的光栅化多边形片段发送到 OpenGL 的下一阶段。 禁用多边形图样时，就好像点阵模式都是所有模式一样。

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

glGetPolygonStipple

glIsEnabled with argument GL_POLYGON_STIPPLE

要求

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

另请参阅

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer