Función glTexEnvfv

La función glTexEnvfv establece un parámetro de entorno de textura.

Sintaxis

void WINAPI glTexEnvfv(
         GLenum  target,
         GLenum  pname,
   const GLfloat *params
);

Parámetros

Destino

Un entorno de textura. Debe ser GL_TEXTURE_ENV.

pname

Nombre simbólico de un parámetro de entorno de textura de un solo valor. Los valores aceptados son GL_TEXTURE_ENV_MODE y GL_TEXTURE_ENV_COLOR.

params

Puntero a una matriz de parámetros: una sola constante simbólica o un color RGBA.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_ENUM	target o pname no era uno de los valores definidos aceptados, o cuando los parámetros deberían haber tenido un valor constante definido (basado en el valor de pname) y no lo hizo.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

Un entorno de textura especifica cómo se interpretan los valores de textura cuando se textura un fragmento. El parámetro de destino debe ser GL_TEXTURE_ENV. El parámetro pname puede ser GL_TEXTURE_ENV_MODE o GL_TEXTURE_ENV_COLOR.

Si pname es GL_TEXTURE_ENV_MODE, los parámetros son (o apunta a) el nombre simbólico de una función de textura. Se definen tres funciones de textura: GL_MODULATE, GL_DECAL y GL_BLEND.

Una función de textura actúa en el fragmento que se va a texturar mediante el valor de la imagen de textura que se aplica al fragmento (vea glTexParameter) y genera un color RGBA para ese fragmento. En la tabla siguiente se muestra cómo se genera el color RGBA para cada una de las tres funciones de textura que se pueden elegir. C es un triple de valores de color (RGB) y A es el valor alfa asociado. Los valores RGBA extraídos de una imagen de textura están en el intervalo [0, 1]. El subíndice f hace referencia al fragmento entrante, el subíndice t a la imagen de textura, el subíndice c al color del entorno de textura y el subíndice v indica un valor generado por la función de textura.

Una imagen de textura puede tener hasta cuatro componentes por elemento de textura (consulta glTexImage1D y glTexImage2D). En una imagen de un componente, Lt indica ese único componente. Una imagen de dos componentes usa L? y A? . Una imagen de tres componentes solo tiene un valor de color, C? . Una imagen de cuatro componentes tiene un valor de color C? y un valor alfa A? .

Número de componentes	GL_MODULATE	GL_DECAL	GL_BLEND
1${REMOVE}$	Cv = ¿L?Cf	undefined${REMOVE}$	Cv = (1L - ?)CfL + ?Cc
	Av = Af		Av = Af
2${REMOVE}$	Cv = ¿L?Cf	undefined${REMOVE}$	Cv = (1L - ?)CfL + ?Cc
	AvAf =		Av = Af
3${REMOVE}$	Cv = ¿C?Cf	Cv = ¿C?	undefined${REMOVE}$
	Av = Af	Av = Af
4${REMOVE}$	Cv = ¿C?Cf	Cv = (1 - A?)CfA + ?¿C?	undefined${REMOVE}$
	Av = ¿Un?Af	Av = Af

Si pname es GL_TEXTURE_ENV_COLOR, los parámetros son un puntero a una matriz que contiene un color RGBA que consta de cuatro valores. Los componentes de color entero se interpretan linealmente de modo que el entero más positivo se asigna a 1,0 y el entero más negativo se asigna a -1,0. Los valores se fijan en el intervalo [0, 1] cuando se especifican. _Cc toma estos cuatro valores.

GL_TEXTURE_ENV_MODE valor predeterminado es GL_MODULATE y GL_TEXTURE_ENV_COLOR valores predeterminados de (0, 0, 0, 0).

La siguiente función recupera información relacionada con glTexEnvfv:

glTexGetEnvfv

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnd

glTexImage1D

glTexImage2D

glTexParameter