glLineStipple 函式

  • 發行項

glLineStipple函式會指定線條 Stipple 模式。

語法

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

參數

因素

行 Stipple 模式中每個位的乘數。 例如，如果 Factor 為 3，則模式中的每個位都會使用三次，然後再使用模式中的下一個位。 因素參數會固定在範圍 [1， 256] ，預設值為一。

模式

16 位整數，其位模式會決定在點陣化線條時繪製線條的片段。 第一次使用位零，而預設模式是全部。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱 意義
GL_INVALID_OPERATION
 在 對 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 [僅限傳統型應用程式]
標頭
Gl.h
程式庫
Opengl32.lib
DLL
Opengl32.dll

另請參閱

glBegin

glEnd

glLineWidth

glPolygonStipple