glLineStipple 函式
glLineStipple函式會指定線條 Stipple 模式。
語法
void WINAPI glLineStipple(
GLint factor,
GLushort pattern
);
參數
-
因素
-
行 Stipple 模式中每個位的乘數。 例如，如果 Factor 為 3，則模式中的每個位都會使用三次，然後再使用模式中的下一個位。 因素參數會固定在範圍 [1， 256] ，預設值為一。
-
模式
-
16 位整數，其位模式會決定在點陣化線條時繪製線條的片段。 第一次使用位零，而預設模式是全部。
傳回值
此函式不會傳回值。
錯誤碼
glGetError函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。 |
備註
glLineStipple函式會指定線條 Stipple 模式。 線條 Stippling 遮罩出點陣化所產生的特定片段;不會繪製這些片段。 遮罩是使用三個參數來達成：16 位線條 Stipple模式模式、重複計數因數，以及整數 Stipple 計數器。
每當呼叫glBegin，並在產生 glBegin (GL_LINES) /glEnd序列的每個線段之前，計數器s會重設為零。 它會在產生單位寬度別名線段的每個片段之後遞增，或在產生i寬度線條線段的每個i片段之後遞增。 如果模式位 (模式位) / mod 16 為零，則會遮罩與計數s相關聯的i片段。 否則，這些片段會傳送至框架緩衝區。 模式的位零是最小有效位。
反鋸齒線條會被視為 1x寬度 矩形的序列，以供 Stippling 之用。 矩形 是 點陣化，或不是根據別名線條所描述的片段規則;它會計算矩形，而不是片段群組。
使用 glEnable 和 glDisable 搭配引數GL_LINE_STIPPLE啟用或停用行 stippling。 啟用時，會套用行 Stipple 模式，如上所述。 停用時，模式就像是所有模式一樣。 一開始會停用行 Stippling。
下列函式會擷取 與 glLineStipple相關的資訊：
glGet with argument GL_LINE_STIPPLE_PATTERN
glGet with argument GL_LINE_STIPPLE_REPEAT
glIsEnabled 與引數GL_LINE_STIPPLE
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|