Função glTexEnvi
A função glTexEnvi define um parâmetro de ambiente de textura.
Sintaxe
void WINAPI glTexEnvi(
GLenum target,
GLenum pname,
GLint param
);
Parâmetros
-
destino
-
Um ambiente de textura. Deve ser GL_TEXTURE_ENV.
-
Pname
-
O nome simbólico de um parâmetro de ambiente de textura de valor único. Deve ser GL_TEXTURE_ENV_MODE.
-
param
-
Uma única constante simbólica, uma de GL_MODULATE, GL_DECAL, GL_BLEND ou GL_REPLACE.
Retornar valor
Essa função não retorna um valor.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
target ou pname não era um dos valores definidos aceitos ou quando os parâmetros deveriam ter um valor constante definido (com base no valor de pname) e não o fizeram. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
Um ambiente de textura especifica como os valores de textura são interpretados quando um fragmento é texturizado. O parâmetro de destino deve ser GL_TEXTURE_ENV. O parâmetro pname é GL_TEXTURE_ENV_MODE. Três funções de textura são definidas: GL_MODULATE, GL_DECAL e GL_BLEND.
Uma função de textura atua no fragmento a ser texturizado usando o valor da imagem de textura que se aplica ao fragmento (consulte glTexParameter) e produz uma cor RGBA para esse fragmento. A tabela a seguir mostra como a cor RGBA é produzida para cada uma das três funções de textura que podem ser escolhidas. C é um triplo de valores de cor (RGB) e A é o valor alfa associado. Os valores RGBA extraídos de uma imagem de textura estão no intervalo [0, 1]. O subscrito f refere-se ao fragmento de entrada, ao subscrito à imagem de textura, ao subscrito c à cor do ambiente de textura e ao subscrito v indica um valor produzido pela função de textura.
Uma imagem de textura pode ter até quatro componentes por elemento de textura (consulte glTexImage1D e glTexImage2D). Em uma imagem de um componente, Lt indica esse único componente. Uma imagem de dois componentes usa L? e A? . Uma imagem de três componentes tem apenas um valor de cor, C? . Uma imagem de quatro componentes tem um valor de cor C? e um valor alfa A? .
| Número de componentes | GL_MODULATE | GL_DECAL | GL_BLEND |
|---|---|---|---|
| 1${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?)Cf + L?Cc |
| Av = Af | Av = Af | ||
| 2${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?)Cf + L?Cc |
| Av = Af | Av = Af | ||
| 3${REMOVE}$ |
Cv = C?Cf | Cv = C? | undefined${REMOVE}$ |
| Av = Af | Av = Af | ||
| 4${REMOVE}$ |
Cv = C?Cf | Cv = (1 - A?)Cf + A?C? | undefined${REMOVE}$ |
| Av = Um?Af | Av = Af |
GL_TEXTURE_ENV_MODE o padrão é GL_MODULATE.
A função a seguir recupera informações relacionadas a glTexEnvi:
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|