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 |
|---|---|
|
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 |
|
| Bibliothek |
|
| DLL |
|