glLineStipple 函数
glLineStipple 函数指定行 stipple 模式。
语法
void WINAPI glLineStipple(
GLint factor,
GLushort pattern
);
参数
-
factor
-
行 stipple 模式中每个位的乘数。 例如，如果 因子 为 3，则模式中的每个位在使用模式中的下一位之前，将使用三次。 因子参数固定在 [1， 256] 范围内，并默认为 1。
-
pattern
-
一个 16 位整数，其位模式确定线光栅化时将绘制线条的哪些片段。 首先使用零位，默认模式为所有模式。
返回值
此函数不返回值。
错误代码
glGetError 函数可以检索以下错误代码。
| 名称 | 含义 |
|---|---|
|
在对 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 [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|