Ler em inglês

Compartilhar via


Função glTexEnvf

A função glTexEnvf define um parâmetro de ambiente de textura.

Sintaxe

void WINAPI glTexEnvf(
   GLenum  target,
   GLenum  pname,
   GLfloat 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 das 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
GL_INVALID_ENUM
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.
GL_INVALID_OPERATION
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 para ser texturizada 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 ao glTexEnvf:

glTexGetEnvfv

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
Gl.h
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glEnd

glTexImage1D

glTexImage2D

glTexParameter