Función glFogfv
La función glFogfv especifica parámetros de niebla.
Sintaxis
void WINAPI glFogfv(
GLenum pname,
const GLfloat *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 de punto flotante que especifica la ecuación que se va a usar para calcular el factor de mezcla 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 de punto flotante que especifica la densidad, la densidad de niebla utilizada en ambas ecuaciones de niebla exponencial. Solo se aceptan densidades noegativas. La densidad predeterminada de niebla es 1,0. - GL_FOG_START
El parámetro params es un valor de punto flotante que especifica el inicio, 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 valor de punto flotante 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 de punto flotante 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 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 contiene solo 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 |
|---|---|
|
pname no era un valor aceptado. |
|
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 mediante 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 glFogfv asigna el valor o los valores en parámetros params al parámetro fog especificado por pname.
Niebla combina un color de niebla con cada color de posttexto de cada fragmento de píxel rasterizado mediante un factor de mezcla f. Factor f se calcula de una de tres maneras, dependiendo del modo niebla. Deje que z sea la distancia en coordenadas oculares desde el origen hasta el fragmento que se está marcando. La ecuación de 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 calcularlo. A continuación, si OpenGL está en modo de color RGBA, el color del fragmento Cr se reemplaza por
En el modo de índice de color, el índice de color del fragmento ir 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 argumento
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 |
|
| Biblioteca |
|
| Archivo DLL |
|