gluNextContour, fonction

Article
06/13/2023

[La fonction gluNextContour est obsolète et fournie à des fins de compatibilité descendante uniquement. La fonction gluNextContour est mappée à gluTessEndContour suivie de gluTessBeginContour.]

La fonction gluNextContour marque le début d’un autre contour.

Syntaxe

void WINAPI gluNextContour(
   GLUtesselator *tess,
   GLenum        type
);

Paramètres

Tess

Objet de pavage (créé avec gluNewTess).

type

Type du contour en cours de définition. Les valeurs suivantes sont valides.

Valeur	Signification
GLU_EXTERIOR	Un contour extérieur définit une limite extérieure du polygone.
GLU_INTERIOR	Un contour intérieur définit une limite intérieure du polygone (par exemple, un trou).
GLU_UNKNOWN	Un contour inconnu est analysé par la bibliothèque pour déterminer s’il est intérieur ou extérieur.
GLU_CCW, GLU_CW	Le premier contour GLU_CCW ou GLU_CW défini est considéré comme extérieur. Tous les autres contours sont considérés comme extérieurs s’ils sont orientés dans la même direction (dans le sens des aiguilles d’une montre ou dans le sens inverse des aiguilles d’une montre) que le premier contour, et intérieur s’ils ne le sont pas. Si un contour est de type GLU_CCW ou GLU_CW, tous les contours doivent être du même type (si ce n’est pas le cas, tous les contours GLU_CCW et GLU_CW sont remplacés par GLU_UNKNOWN). Notez qu’il n’existe aucune différence réelle entre les types de contour GLU_CCW et GLU_CW.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

Utilisez la fonction gluNextContour pour décrire des polygones avec plusieurs contours. Après avoir décrit le premier contour par le biais d’une série d’appels gluTessVertex , un appel gluNextContour indique que le contour précédent est terminé et que le contour suivant est sur le point de commencer. Effectuez une autre série d’appels gluTessVertex pour décrire le nouveau contour. Répétez ce processus jusqu’à ce que tous les contours aient été décrits.

Le paramètre type définit le type de contour suivant.

Pour définir le type du premier contour, vous pouvez appeler gluNextContour avant de décrire le premier contour. Si vous n’appelez pas gluNextContour avant le premier contour, le premier contour est marqué GLU_EXTERIOR.

Exemples

Vous pouvez décrire un quadrilatéral avec un trou triangulaire comme suit :

gluBeginPolygon(tess); 
    gluTessVertex(tess, v1, v1); 
    gluTessVertex(tess, v2, v2); 
    gluTessVertex(tess, v3, v3); 
    gluTessVertex(tess, v4, v4);  
gluNextContour(tess, GLU_INTERIOR); 
    gluTessVertex(tess, v5, v5); 
    gluTessVertex(tess, v6, v6); 
    gluTessVertex(tess, v7, v7);  
gluEndPolygon(tess);

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	Glu.h
Bibliothèque	Glu32.lib
DLL	Glu32.dll

Voir aussi

gluNewTess
gluTessBeginContour
gluTessBeginPolygon
gluTessCallback
gluTessEndContour
gluTessVertex

Partager via