glPointSize-Funktion

Die glPointSize-Funktion gibt den Durchmesser von rasterisierten Punkten an.

Syntax

void WINAPI glPointSize(
   GLfloat size
);

Parameter

size

Der Durchmesser von gerasterten Punkten. Der Standardwert ist 1.0.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name	Bedeutung
GL_INVALID_VALUE	größe war kleiner oder gleich 0.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glPointSize-Funktion gibt den rasterisierten Durchmesser von Alias- und Antialiasedpunkten an. Die Verwendung einer anderen Punktgröße als 1.0 hat unterschiedliche Auswirkungen, je nachdem, ob das Punkt-Antialiasing aktiviert ist. Die Punkt-Antialiasing wird durch Aufrufen von glEnable und glDisable mit argument GL_POINT_SMOOTH gesteuert.

Wenn die Punkt-Antialiasing deaktiviert ist, wird die tatsächliche Größe bestimmt, indem die angegebene Größe auf die nächste ganze Zahl gerundet wird. (Wenn die Rundung den Wert 0 ergibt, ist es so, als wäre die Punktgröße 1.) Wenn die abgerundete Größe ungerade ist, wird der Mittelpunkt (x,y) des Pixelfragments, der den Punkt darstellt, als berechnet.

(x_w + .5, y_w + .5)

Wobei w-Tiefgestellt fensterkoordinaten angeben. Alle Pixel, die innerhalb des quadratischen Rasters der gerundeten Größe mit zentriert (x,y) liegen, bilden das Fragment. Wenn die Größe gerade ist, ist der Mittelpunkt

(x_w + .5, y_w + .5)

und die Mittelpunkte des gerasterten Fragments sind die halbzahligen Fensterkoordinaten innerhalb des Quadrats der gerundeten Größe mit zentriert (x,y). Allen Pixelfragmenten, die beim Rastern eines nicht antiantialiasierten Punkts erzeugt werden, werden die gleichen zugeordneten Daten zugewiesen. die des Scheitelpunkts, der dem Punkt entspricht.

Wenn antialiasing aktiviert ist, erzeugt die Punktrasterung ein Fragment für jedes Pixelquadrat, das den innerhalb des Kreises liegenden Bereich mit einem Durchmesser schneidet, der der aktuellen Punktgröße entspricht und an den Punkten zentriert ist (x_w , y_w ). Der Abdeckungswert für jedes Fragment ist der Fensterkoordinatenbereich der Schnittmenge des kreisförmigen Bereichs mit dem entsprechenden Pixelquadrat. Dieser Wert wird gespeichert und im letzten Rasterungsschritt verwendet. Die daten, die jedem Fragment zugeordnet sind, sind die Daten, die dem zu rasterisierenden Punkt zugeordnet sind.

Nicht alle Größen werden unterstützt, wenn punktbezogenes Antialiasing aktiviert ist. Wenn eine nicht unterstützte Größe angefordert wird, wird die nächste unterstützte Größe verwendet. Nur Größe 1.0 wird garantiert unterstützt; andere hängen von der Implementierung ab. Der Bereich der unterstützten Größen und der Größenunterschied zwischen unterstützten Größen innerhalb des Bereichs können abgefragt werden, indem glGet mit Argumenten GL_POINT_SIZE_RANGE und GL_POINT_SIZE_GRANULARITY aufgerufen wird.

Die von glPointSize angegebene Punktgröße wird immer zurückgegeben, wenn GL_POINT_SIZE abgefragt wird. Klemmen und Rundungen für Alias- und Antialiasedpunkte haben keine Auswirkung auf den angegebenen Wert.

Nicht antialiasierte Punktgröße kann auf ein implementierungsabhängiges Maximum geklemmt werden. Obwohl dieses Maximum nicht abgefragt werden kann, darf er nicht kleiner als der Maximalwert für Antialiased-Punkte sein, gerundet auf den nächsten ganzzahligen Wert.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glPointSize ab:

glGet mit Argument GL_POINT_SIZE

glGet mit Argument GL_POINT_SIZE_RANGE

glGet mit argument GL_POINT_SIZE_GRANULARITY

glIsEnabled mit Argument GL_POINT_SMOOTH

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glEnable

glEnd

glIsEnabled