funzione glColorMask
La funzione glColorMask abilita e disabilita la scrittura di componenti di colore del buffer di frame.
Sintassi
void WINAPI glColorMask(
GLboolean red,
GLboolean green,
GLboolean blue,
GLboolean alpha
);
Parametri
-
red
-
Specificare se il rosso può o non può essere scritto nel framebuffer. I valori predefiniti sono GL_TRUE, a indicare che è possibile scrivere il componente colore.
-
green
-
Specificare se il verde può o non può essere scritto nel framebuffer. Il valore predefinito è GL_TRUE, a indicare che è possibile scrivere il componente colore.
-
blue
-
Specificare se il blu può o non può essere scritto nel framebuffer. Il valore predefinito è GL_TRUE, a indicare che è possibile scrivere il componente colore.
-
Alfa
-
Specificare se alfa può o non può essere scritto nel framebuffer. Il valore predefinito è GL_TRUE, a indicare che è possibile scrivere il componente colore.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
Il codice di errore seguente può essere recuperato dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glColorMask specifica se i singoli componenti di colore nel framebuffer possono o meno essere scritti. Se il rosso è GL_FALSE, ad esempio, non viene apportata alcuna modifica al componente rosso di qualsiasi pixel in uno dei buffer di colore, indipendentemente dall'operazione di disegno tentata.
Non è possibile controllare le modifiche ai singoli bit dei componenti. Le modifiche sono invece abilitate o disabilitate per l'intero componente colore.
Le funzioni seguenti recuperano informazioni correlate a glColorMask:
glGet con argomento GL_COLOR_WRITEMASK
glGet con argomento GL_RGBA_MODE
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|