fonction glColorMask

  • Article

La fonction glColorMask active et désactive l’écriture des composants de couleur de la mémoire tampon de trame.

Syntaxe

void WINAPI glColorMask(
   GLboolean red,
   GLboolean green,
   GLboolean blue,
   GLboolean alpha
);

Paramètres

rouge

Spécifiez si le rouge peut ou ne peut pas être écrit dans le framebuffer. Les valeurs par défaut sont GL_TRUE, ce qui indique que le composant de couleur peut être écrit.

vert

Spécifiez si le vert peut ou ne peut pas être écrit dans le framebuffer. La valeur par défaut est GL_TRUE, ce qui indique que le composant de couleur peut être écrit.

blue

Spécifiez si le bleu peut ou ne peut pas être écrit dans le framebuffer. La valeur par défaut est GL_TRUE, ce qui indique que le composant de couleur peut être écrit.

alpha

Spécifiez si alpha peut ou ne peut pas être écrit dans le framebuffer. La valeur par défaut est GL_TRUE, ce qui indique que le composant de couleur peut être écrit.

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

La fonction glColorMask spécifie si les composants de couleur individuels dans le framebuffer peuvent ou ne peuvent pas être écrits. Si le rouge est GL_FALSE, par exemple, aucune modification n’est apportée au composant rouge d’un pixel dans l’une des mémoires tampons de couleur, quelle que soit l’opération de dessin tentée.

Les modifications apportées à des bits de composants individuels ne peuvent pas être contrôlées. Au lieu de cela, les modifications sont activées ou désactivées pour l’ensemble des composants de couleur.

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

glGet avec argument GL_COLOR_WRITEMASK

glGet avec GL_RGBA_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

glColor

glDepthMask

glEnd

glGet

glIndex

glIndexMask

glStencilMask