glPolygonMode, fonction

Article
06/13/2023

La fonction glPolygonMode sélectionne un mode de rastérisation de polygones.

Syntaxe

void WINAPI glPolygonMode(
   GLenum face,
   GLenum mode
);

Paramètres

Visage

Polygones auxquels le mode s’applique. Doit être GL_FRONT pour les polygones avant, GL_BACK pour les polygones arrière ou GL_FRONT_AND_BACK pour les polygones avant et arrière.

mode

La façon dont les polygones seront rastérisés. Les modes suivants sont définis et peuvent être spécifiés en mode. La valeur par défaut est GL_FILL pour les polygones avant et arrière.

Valeur	Signification
GL_POINT	Les sommets polygonaux marqués comme début d’un bord limite sont dessinés en tant que points. Les attributs de point tels que GL_POINT_SIZE et GL_POINT_SMOOTH contrôlent la rastérisation des points. Les attributs de rastérisation de polygones autres que GL_POLYGON_MODE n’ont aucun effet.
GL_LINE	Les bords limites du polygone sont dessinés sous forme de segments de ligne. Ils sont traités comme des segments de ligne connectés pour le stippling de ligne; Le compteur et le modèle d’info-bulles de ligne ne sont pas réinitialisés entre les segments (voir glLineStipple). Les attributs de ligne tels que GL_LINE_WIDTH et GL_LINE_SMOOTH contrôlent la rastérisation des lignes. Les attributs de rastérisation de polygones autres que GL_POLYGON_MODE n’ont aucun effet.
GL_FILL	L’intérieur du polygone est rempli. Les attributs polygonaux tels que GL_POLYGON_STIPPLE et GL_POLYGON_SMOOTH contrôlent la rastérisation du polygone.

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 .

Nom	Signification
GL_INVALID_ENUM	Face oumode n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glPolygonMode contrôle l’interprétation des polygones pour la rastérisation. Le paramètre face décrit à quel mode polygones s’applique : polygones avant (GL_FRONT), polygones arrière (GL_BACK) ou les deux (GL_FRONT_AND_BACK). Le mode polygone affecte uniquement la rastérisation finale des polygones. En particulier, les sommets d’un polygone sont allumés et le polygone est coupé et éventuellement éliminé avant que ces modes ne soient appliqués.

Pour dessiner une surface avec des polygones arrière remplis et des polygones avant en contour, appelez

glPolygonMode(GL_FRONT, GL_LINE);

Les sommets sont marqués comme limites ou non limites avec un indicateur d’arête. Les indicateurs de périphérie sont générés en interne par OpenGL lorsqu’il décompose les polygones, et ils peuvent être définis explicitement à l’aide de glEdgeFlag.

La fonction suivante récupère les informations relatives à glPolygonMode :

glGet avec GL_POLYGON_MODE d’arguments

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
glEdgeFlag
glEnd
glLineStipple
glLineWidth
glPointSize
glPolygonStipple

Partager via