glLineStipple 函数

glLineStipple 函数指定行 stipple 模式。

语法

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

参数

factor

行 stipple 模式中每个位的乘数。 例如，如果 因子 为 3，则模式中的每个位在使用模式中的下一位之前，将使用三次。 因子参数固定在 [1， 256] 范围内，并默认为 1。

pattern

一个 16 位整数，其位模式确定线光栅化时将绘制线条的哪些片段。 首先使用零位，默认模式为所有模式。

返回值

此函数不返回值。

错误代码

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

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

备注

glLineStipple 函数指定行 stipple 模式。 线条碎片掩盖光栅化产生的某些片段;不会绘制这些片段。 掩码是使用三个参数实现的：16 位线点模式 模式、重复计数 因子和整数计数计数器 s。

每当调用 glBegin 时，计数器 将重置为零，并在生成 glBegin (GL_LINES) /glEnd 序列的每个行段之前。 在生成单位宽度别名线段的每个片段后，或在生成 i 宽度线段的每个 i 片段之后，该段递增。 如果模式位 (因子) / mod 16 为零，则会屏蔽与 count s 关联的 i 片段。 否则，这些片段将发送到 framebuffer。 模式的零位是最小有效位。

抗锯齿线被视为 1x宽度 矩形的序列，以便进行固定。 矩形 是 光栅化或不基于为别名线描述的片段规则;它计算矩形而不是片段组。

使用 glEnable 和 glDisable 以及参数GL_LINE_STIPPLE启用或禁用行存根。 启用后，将按上述方式应用行点模式。 禁用时，就像模式都是所有模式一样。 最初，行存根是禁用的。

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

带参数GL_LINE_STIPPLE_PATTERN的 glGet

带参数GL_LINE_STIPPLE_REPEAT的 glGet

glIsEnabled with argument GL_LINE_STIPPLE

要求

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

另请参阅

glBegin

glEnd

glLineWidth

glPolygonStipple