glLineWidth 函式

glLineWidth函式會指定點陣化線條的寬度。

語法

void WINAPI glLineWidth(
   GLfloat width
);

參數

寬度

點陣化線條的寬度。 預設值為 1.0。

傳回值

此函式不會傳回值。

錯誤碼

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

名稱	意義
GL_INVALID_VALUE	width 小於或等於零。
GL_INVALID_OPERATION	函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glLineWidth函式會指定鋸齒和反鋸齒線條的點陣化寬度。 使用 1.0 以外的線條寬度會有不同的效果，視是否啟用線條反鋸齒而定。 行反鋸齒是由呼叫 glEnable 和 glDisable 搭配引數GL_LINE_SMOOTH來控制。

如果停用線條反鋸齒，則實際寬度是由將提供的寬度四捨五入為最接近的整數來決定。 (如果四捨五入結果值為 0.0，就如同行寬為 1.0) If | ？ x |= | ? y |， i 圖元會填入點陣化的每個資料行，其中 i 是 寬度的四捨五入值。 否則， i 圖元會填入點陣化的每個資料列。

如果啟用反鋸齒，線條點陣化會針對每個圖元方塊產生片段，其與矩形內的區域相交，寬度等於目前的線條寬度、長度等於線條的實際長度，並以數學線段為中心。 每個片段的涵蓋範圍值是矩形區域與對應圖元方形交集的視窗座標區域。 此值會儲存並用於最終點陣化步驟。

啟用線條反鋸齒時，並非所有寬度都可以支援。 如果要求不支援的寬度，則會使用最接近支援的寬度。 只保證支援寬度 1.0;其他相依于 實作。 您可以藉由呼叫 glGet 搭配引數GL_LINE_WIDTH_RANGE和GL_LINE_WIDTH_GRANULARITY，來查詢範圍內支援寬度和大小差異的範圍。

查詢GL_LINE_WIDTH時，一律會傳回 glLineWidth 指定的線條寬度。 別名和反鋸齒線的固定和四捨五入不會影響指定的值。

非反鋸齒線條寬度可能會限制為實作相依的最大值。 雖然無法查詢此最大值，但不能小於反鋸齒線的最大值，四捨五入為最接近的整數值。

下列函式會擷取 與 glLineWidth相關的資訊：

glGet with argument GL_LINE_WIDTH

glGet with argument GL_LINE_WIDTH_RANGE

glGet with argument GL_LINE_WIDTH_GRANULARITY

glIsEnabled with argument GL_LINE_SMOOTH

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Gl.h
程式庫	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glEnable

glEnd

glIsEnabled