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
GL_INVALID_OPERATION	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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glDepthFunc

glDisable

glEnable

glGet

glIsEnabled

glLineWidth

glStencilOp

glTexEnv