glColorMask-Funktion

Die glColorMask-Funktion aktiviert und deaktiviert das Schreiben von Framepuffer-Farbkomponenten.

Syntax

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

Parameter

Rot

Geben Sie an, ob Rot in den Framepuffer geschrieben werden kann. Die Standardwerte sind GL _ TRUE und geben an, dass die Farbkomponente geschrieben werden kann.

Grün

Geben Sie an, ob Grün in den Framepuffer geschrieben werden kann. Der Standardwert ist GL _ TRUE, was angibt, dass die Farbkomponente geschrieben werden kann.

Blau

Geben Sie an, ob Blau in den Framepuffer geschrieben werden kann. Der Standardwert ist GL _ TRUE, was angibt, dass die Farbkomponente geschrieben werden kann.

alpha

Geben Sie an, ob Alpha in den Framepuffer geschrieben werden kann. Der Standardwert ist GL _ TRUE, was angibt, dass die Farbkomponente geschrieben werden kann.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name Bedeutung
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glColorMask-Funktion gibt an, ob die einzelnen Farbkomponenten im Framepuffer geschrieben werden können oder nicht. Wenn rot gl false ist, wird z. B. keine Änderung an der roten Komponente eines Pixels in einem der Farbpuffer vorgenommen, unabhängig vom versuchten _ Zeichnungsvorgang.

Änderungen an einzelnen Komponentenbits können nicht gesteuert werden. Stattdessen werden Änderungen für ganze Farbkomponenten aktiviert oder deaktiviert.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glColorMask ab:

glGet mit Argument GL _ COLOR _ WRITEMASK

glGet mit Argument GL _ RGBA _ MODE

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glColor

glDepthMask

glEnd

glGet

glIndex

glIndexMask

glStencilMask