glPolygonOffset, fonction
La fonction glPolygonOffset définit l’échelle et les unités qu’OpenGL utilise pour calculer les valeurs de profondeur.
Syntaxe
void WINAPI glPolygonOffset(
GLfloat factor,
GLfloat units
);
Paramètres
-
Facteur
-
Spécifie un facteur d’échelle utilisé pour créer un décalage de profondeur variable pour chaque polygone. La valeur initiale est zéro.
-
Unités
-
Spécifie une valeur multipliée par une valeur spécifique à l’implémentation pour créer un décalage de profondeur constant. La valeur initiale est 0.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Codes d’erreur
Le code d’erreur suivant peut être récupéré par la fonction glGetError .
| Name | Signification |
|---|---|
|
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd. |
Notes
Lorsque GL_POLYGON_OFFSET est activé, la valeur de profondeur de chaque fragment est décalée après avoir été interpolée à partir des valeurs de profondeur des sommets appropriés. La valeur du décalage est factor * ?z + r *units, où ?z est une mesure de la modification de profondeur par rapport à la zone d’écran du polygone, et r est la plus petite valeur qui est garantie pour produire un décalage résolvable pour une implémentation donnée. Le décalage est ajouté avant l’exécution du test de profondeur et avant l’écriture de la valeur dans la mémoire tampon de profondeur.
La fonction glPolygonOffset est utile pour le rendu d’images de ligne masquée, pour appliquer des décalques aux surfaces et pour le rendu de solides avec des bords mis en surbrillance.
La fonction glPolygonOffset n’a aucun effet sur les coordonnées de profondeur placées dans la mémoire tampon de retour. Il n’a pas non plus d’effet sur la sélection.
Les fonctions suivantes récupèrent des informations relatives à glPolygonOffset :
- glGet avec GL_POLYGON_OFFSET_FACTOR d’arguments
- glGet avec argument GL_POLYGON_OFFSET_UNITS
- glIsEnabled avec argument GL_POLYGON_OFFSET_FILL
- glIsEnabled avec argument GL_POLYGON_OFFSET_LINE
- glIsEnabled avec argument GL_POLYGON_OFFSET_POINT
Notes
La fonction glPolygonOffset est disponible uniquement dans OpenGl version 1.1 ou ultérieure.
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 |
|
| Bibliothèque |
|
| DLL |
|