Función glFogiv

La función glFogfv especifica parámetros de niebla.

Sintaxis

void WINAPI glFogiv(
         GLenum pname,
   const GLint  *params
);

Parámetros

pname

Especifica un parámetro de niebla.

Acepta uno de los valores siguientes.

Value	Significado
GL_FOG_MODE	El parámetro params es un valor entero único que especifica la ecuación que se va a usar para calcular el factor de fusión de niebla, f. Se aceptan tres constantes simbólicas: GL_LINEAR, GL_EXP y GL_EXP2. Las ecuaciones correspondientes a estas constantes simbólicas se definen en la siguiente sección Comentarios. El modo de niebla predeterminado es GL_EXP.
GL_FOG_DENSITY	El parámetro params es un valor entero único que especifica la densidad, la densidad de niebla utilizada en ambas ecuaciones de niebla exponencial. Solo se aceptan densidades no negativo. La densidad de niebla predeterminada es 1,0.
GL_FOG_START	El parámetro params es un valor entero único que especifica start, la distancia cercana utilizada en la ecuación de niebla lineal. La distancia cercana predeterminada es 0,0.
GL_FOG_END	El parámetro params es un único valor entero que especifica end, la distancia lejana utilizada en la ecuación de niebla lineal. La distancia predeterminada es 1,0.
GL_FOG_INDEX	El parámetro params es un valor entero único que especifica if , el índice de color de niebla. El índice de niebla predeterminado es 0,0.
GL_FOG_COLOR	El parámetro params contiene cuatro valores enteros o de punto flotante que especifican Cf , el color de niebla. Los valores enteros se asignan linealmente de modo que el valor representable más positivo se asigna a 1,0 y el valor representable más negativo se asigna a -1,0. Los valores de punto flotante se asignan directamente. Después de la conversión, todos los componentes de color se sujetan al intervalo [0,1]. El color de niebla predeterminado es (0,0,0,0).

params

Especifica el valor o los valores que se van a asignar a pname. GL_FOG_COLOR requiere una matriz de cuatro valores. Todos los demás parámetros aceptan una matriz que solo contiene un valor único.

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	pname no era un valor aceptado.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

Habilite y deshabilite la niebla con glEnable y glDisable, utilizando el argumento GL_FOG. Mientras está habilitada, la niebla afecta a la geometría rasterizada, los mapas de bits y los bloques de píxeles, pero no a las operaciones de borrado de búfer.

La función glFogiv asigna el valor o los valores en parámetros de niebla al parámetro de niebla especificado por pname.

Niebla combina un color de niebla con cada color posttexturado de fragmento de píxeles rasterizado mediante un factor de mezcla f. Factor f se calcula de una de tres maneras, dependiendo del modo de niebla. Deje que z sea la distancia en coordenadas oculares desde el origen hasta el fragmento que se está marcando. La ecuación para GL_LINEAR niebla es:

La ecuación para GL_EXP niebla es:

La ecuación para GL_EXP2 niebla es:

Independientemente del modo de niebla, f se sujeta al intervalo [0,1] después de que se calcule. A continuación, si OpenGL está en modo de color RGBA, el color del fragmento C_r se reemplaza por

En el modo de índice de color, el índice de color del fragmento i_r se reemplaza por

Las siguientes funciones recuperan información relacionada con las funciones glFog :

glGet con GL_FOG_COLOR de argumentos

glGet con GL_FOG_INDEX de argumentos

glGet con GL_FOG_DENSITY de argumentos

glGet con GL_FOG_START de argumentos

glGet con GL_FOG_END de argumentos

glGet con GL_FOG_MODE de argumentos

glIsEnabled con GL_FOG de argumentos

Requisitos

Requisito	Value
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

glDisable

glEnable

glEnd

glGet

glIsEnabled