glPointSize 函式

glPointSize函式會指定點陣化點的直徑。

語法

void WINAPI glPointSize(
   GLfloat size
);

此函式不會傳回值。

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

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

glPointSize函式會指定鋸齒和反鋸齒點的點陣化直徑。根據是否啟用點反鋸齒，使用 1.0 以外的點大小會有不同的效果。點反鋸齒是由呼叫 glEnable 和 glDisable 搭配引數GL_POINT_SMOOTH來控制。

如果停用點反鋸齒，則會將提供的大小四捨五入為最接近的整數來決定實際大小。 (如果四捨五入結果值為 0，就如同點大小為 1.) 如果四捨五入大小為奇數，則表示該點的圖元片段 (x，y) 的中心點會計算為

(x_w + .5， y_w + .5)

其中 w 注標表示視窗座標。位於四捨五入大小的方形方格內的所有圖元，以 (x，y) 組成片段。如果大小為偶數，中心點是

(x_w + .5， y_w + .5)

和點陣化片段的中心是四捨五入大小以 (x，y) 置中方塊中的半整數視窗座標。點陣化非反驗證點所產生的所有圖元片段都會指派相同的相關聯資料;對應至點之頂點的頂點。

如果已啟用反鋸齒，則點陣化會針對每個圖元方塊產生片段，該片段會與圓圈內相交的區域，其直徑等於目前點大小，並置中于 x_w 、y_w ) 的點 (置中。每個片段的涵蓋範圍值是圓形區域與對應圖元方形交集的視窗座標區域。此值會儲存並用於最終點陣化步驟。與每個片段相關聯的資料是與點陣化相關聯的資料。

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

查詢GL_POINT_SIZE時，一律會傳回 glPointSize 指定的點大小。別名和反鋸齒點的固定和四捨五入不會影響指定的值。

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

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

glGet with argument GL_POINT_SIZE

glGet with argument GL_POINT_SIZE_RANGE

具有引數的glGet GL_POINT_SIZE_GRANULARITY

glIsEnabled with argument GL_POINT_SMOOTH

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