glPolygonMode, fonction
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 |
|---|---|
|
Face oumode n’était pas une valeur acceptée. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|