glColorMask-Funktion
Die glColorMask-Funktion aktiviert und deaktiviert das Schreiben von Frame-Puffer-Farbkomponenten.
Syntax
void WINAPI glColorMask(
GLboolean red,
GLboolean green,
GLboolean blue,
GLboolean alpha
);
Parameter
-
rot
-
Geben Sie an, ob Rot in den Framebuffer geschrieben werden kann oder nicht. Die Standardwerte sind GL_TRUE, was angibt, dass die Farbkomponente geschrieben werden kann.
-
grün
-
Geben Sie an, ob Grün in den Framebuffer geschrieben werden kann oder nicht. Der Standardwert ist GL_TRUE, was angibt, dass die Farbkomponente geschrieben werden kann.
-
blau
-
Geben Sie an, ob Blau in den Framebuffer geschrieben werden kann oder nicht. Der Standardwert ist GL_TRUE, was angibt, dass die Farbkomponente geschrieben werden kann.
-
alpha
-
Geben Sie an, ob Alpha in den Framebuffer geschrieben werden kann oder nicht. 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 Framebuffer geschrieben werden können oder nicht. Wenn rot z. B. GL_FALSE ist, wird die rote Komponente eines Beliebigen Pixels in einem der Farbpuffer nicht geändert, 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
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 |
|