fonction glPointSize

La fonction glPointSize spécifie le diamètre des points rastérisés.

Syntaxe

void WINAPI glPointSize(
   GLfloat size
);

Paramètres

size

Diamètre des points rastérisés. La valeur par défaut est 1.0.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Name	Signification
GL_INVALID_VALUE	taille inférieure ou égale à zéro.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glPointSize spécifie le diamètre rastérisé des points alias et anticrénelés. L’utilisation d’une taille de point autre que 1.0 a des effets différents, selon que l’anticrénelage de point est activé ou non. L’anticrénelage de point est contrôlé en appelant glEnable et glDisable avec l’argument GL_POINT_SMOOTH.

Si l’anticrénelage de point est désactivé, la taille réelle est déterminée en arrondissant la taille fournie à l’entier le plus proche. (Si l’arrondi donne la valeur 0, c’est comme si la taille de point était 1.) Si la taille arrondie est impaire, le point central (x,y) du fragment de pixel qui représente le point est calculé comme

(x_w + .5, y_w + .5)

où les indices w indiquent les coordonnées de la fenêtre. Tous les pixels qui se trouvent dans la grille carrée de la taille arrondie centrée sur (x,y) composent le fragment. Si la taille est égale, le point central est

(x_w + .5, y_w + .5)

et les centres du fragment rastérisé sont les coordonnées de la fenêtre demi-entier dans le carré de la taille arrondie centrée à (x,y). Tous les fragments de pixels produits lors du rastérisation d’un point non sous-traité se voient attribuer les mêmes données associées ; celui du sommet correspondant au point.

Si l’anticrénelage est activé, la rastérisation de point produit un fragment pour chaque carré de pixels qui croise la région située dans le cercle dont le diamètre est égal à la taille de point actuelle et centré sur les points (x_w ,y_w ). La valeur de couverture pour chaque fragment est la zone de coordonnées de fenêtre de l’intersection de la région circulaire avec le carré de pixel correspondant. Cette valeur est enregistrée et utilisée dans l’étape de rastérisation finale. Les données associées à chaque fragment sont les données associées au point en cours de rastérisé.

Toutes les tailles ne sont pas prises en charge lorsque l’anticrénelage de point est activé. Si une taille non prise en charge est demandée, la taille prise en charge la plus proche est utilisée. Seule la taille 1.0 est garantie d’être prise en charge ; d’autres dépendent de l’implémentation. La plage de tailles prises en charge et la différence de taille entre les tailles prises en charge dans la plage peuvent être interrogées en appelant glGet avec des arguments GL_POINT_SIZE_RANGE et GL_POINT_SIZE_GRANULARITY.

La taille de point spécifiée par glPointSize est toujours retournée lorsque GL_POINT_SIZE est interrogé. Le serrage et l’arrondi des points alias et anticrénelés n’ont aucun effet sur la valeur spécifiée.

La taille des points non anticrénelés peut être limitée à un maximum dépendant de l’implémentation. Bien que cette valeur maximale ne puisse pas être interrogée, elle ne doit pas être inférieure à la valeur maximale pour les points anticrénelés, arrondie à la valeur entière la plus proche.

Les fonctions suivantes récupèrent des informations relatives à glPointSize :

glGet avec argument GL_POINT_SIZE

glGet avec argument GL_POINT_SIZE_RANGE

glGet avec GL_POINT_SIZE_GRANULARITY d’arguments

glIsEnabled avec argument GL_POINT_SMOOTH

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glEnable

glEnd

glIsEnabled