glPolygonStipple, fonction

La fonction glPolygonStipple définit le modèle de stippling de polygones.

Syntaxe

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

Paramètres

mask

Pointeur vers un modèle stipple 32x32 qui sera décompressé de la mémoire de la même façon que glDrawPixels décompresse les pixels.

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 .

Nom	Signification
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glPolygonStipple définit le modèle de stippling de polygones. Le stippling polygonal, comme le stippling de trait (voir glLineStipple), masque certains fragments produits par la rastérisation, créant ainsi un modèle. Le stippling est indépendant de l’anticrénelage de polygones.

Le paramètre mask est un pointeur vers un modèle d’info-bulle de 32 x 32 stocké en mémoire, tout comme les données de pixel fournies à glDrawPixels avec une hauteur et une largeur égales à 32, un format de pixels de GL_COLOR_INDEX et un type de données de GL_BITMAP. Autrement dit, le modèle d’info-bulles est représenté sous la forme d’un tableau 32x32 d’index de couleur 1 bits empaquetés en octets non signés. Les paramètres de la fonction glPixelStore , tels que GL_UNPACK_SWAP_BYTES et GL_UNPACK_LSB_FIRST, affectent l’assemblage des bits dans un modèle de stipple. Toutefois, les opérations de transfert de pixels (décalage, décalage et mappage de pixels) ne sont pas appliquées à l’image d’info-bulle.

Le stippling de polygones est activé et désactivé avec glEnable et glDisable, à l’aide de GL_POLYGON_STIPPLE d’arguments. Si cette option est activée, un fragment de polygone rastérisé avec les coordonnées de fenêtre x_w et y_w est envoyé à l’étape suivante d’OpenGL si et seulement si le (x_w mod 32)th bit dans la (y_w mod 32)th ligne du modèle stipple est un. Lorsque le stippling polygonal est désactivé, c’est comme si le modèle stipple était tous des.

Les fonctions suivantes récupèrent des informations relatives à glPolygonStipple :

glGetPolygonStipple

glIsEnabled avec argument GL_POLYGON_STIPPLE

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

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer