funzione glTexEnvi
La funzione glTexEnvi imposta un parametro di ambiente trama.
void WINAPI glTexEnvi(
GLenum target,
GLenum pname,
GLint param
);
-
target
-
Ambiente trama. Deve essere GL_TEXTURE_ENV.
-
Pname
-
Nome simbolico di un parametro di ambiente trama a valore singolo. Deve essere GL_TEXTURE_ENV_MODE.
-
param
-
Una singola costante simbolica, una di GL_MODULATE, GL_DECAL, GL_BLEND o GL_REPLACE.
Questa funzione non restituisce un valore.
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
Nome | Significato |
---|---|
|
target o pname non è uno dei valori definiti accettati o quando i params devono avere un valore costante definito (in base al valore di pname) e non hanno fatto. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Un ambiente trama specifica il modo in cui i valori della trama vengono interpretati quando un frammento viene tramato. Il parametro di destinazione deve essere GL_TEXTURE_ENV. Il parametro pname è GL_TEXTURE_ENV_MODE. Vengono definite tre funzioni di trama: GL_MODULATE, GL_DECAL e GL_BLEND.
Una funzione trama agisce sul frammento per la trama usando il valore dell'immagine della trama che si applica al frammento (vedere glTexParameter) e produce un colore RGBA per tale frammento. Nella tabella seguente viene illustrato come viene prodotto il colore RGBA per ognuna delle tre funzioni di trama che possono essere scelte. C è un triplo di valori di colore (RGB) e A è il valore alfa associato. I valori RGBA estratti da un'immagine di trama si trovano nell'intervallo [0, 1]. La sottoscrizione f fa riferimento al frammento in ingresso, alla sottoscript t all'immagine della trama, alla descrizione c al colore dell'ambiente trama e alla v di codice indica un valore prodotto dalla funzione trama.
Un'immagine di trama può avere fino a quattro componenti per elemento trama (vedere glTexImage1D e glTexImage2D). In un'immagine a un componente, Lt indica che il singolo componente. Un'immagine a due componenti usa L? e A? . Un'immagine a tre componenti ha solo un valore di colore, C? . Un'immagine a quattro componenti ha sia un valore di colore C che un valore alfa A? .
Numero di componenti | GL_MODULATE | GL_DECAL | GL_BLEND |
---|---|---|---|
1${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?)Cf + L?Cc |
Av = F | Av = F | ||
2${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?)Cf + L?Cc |
Av = F | Av = F | ||
3${REMOVE}$ |
Cv = C?Cf | Cv = C? | undefined${REMOVE}$ |
Av = F | Av = F | ||
4${REMOVE}$ |
Cv = C?Cf | Cv = (1 - A?)Cf + A?C? | undefined${REMOVE}$ |
Av = Un?F | Av = F |
GL_TEXTURE_ENV_MODE impostazione predefinita per GL_MODULATE.
La funzione seguente recupera informazioni correlate a glTexEnvi:
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|
Libreria |
|
DLL |
|