Função glFogfv

A função glFogfv especifica parâmetros de neblina.

Sintaxe

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

Parâmetros

Pname

Especifica um parâmetro de neblina.

Aceita um dos valores a seguir.

Valor	Significado
GL_FOG_MODE	O parâmetro params é um valor de ponto flutuante que especifica a equação a ser usada para calcular o fator de mesclagem de neblina, f. Três constantes simbólicas são aceitas: GL_LINEAR, GL_EXP e GL_EXP2. As equações correspondentes a essas constantes simbólicas são definidas na seção Comentários a seguir. O modo de neblina padrão é GL_EXP.
GL_FOG_DENSITY	O parâmetro params é um valor de ponto flutuante que especifica densidade, a densidade de neblina usada em ambas as equações de neblina exponencial. Somente densidades não negativos são aceitas. A densidade de neblina padrão é 1,0.
GL_FOG_START	O parâmetro params é um valor de ponto flutuante que especifica start, a distância próxima usada na equação de neblina linear. A distância próxima padrão é 0,0.
GL_FOG_END	O parâmetro params é um valor de ponto flutuante que especifica end, a distância distante usada na equação de neblina linear. A distância distante padrão é 1,0.
GL_FOG_INDEX	O parâmetro params é um valor de ponto flutuante que especifica if , o índice de cor de neblina. O índice de neblina padrão é 0,0.
GL_FOG_COLOR	O parâmetro params contém quatro valores de ponto flutuante que especificam Cf , a cor da neblina. Os valores inteiros são mapeados linearmente de modo que o valor representável mais positivo seja mapeado para 1,0 e o valor representável mais negativo seja mapeado para -1,0. Os valores de ponto flutuante são mapeados diretamente. Após a conversão, todos os componentes de cor são fixados no intervalo [0,1]. A cor de neblina padrão é (0,0,0,0).

params

Especifica o valor ou os valores a serem atribuídos ao pname. GL_FOG_COLOR requer uma matriz de quatro valores. Todos os outros parâmetros aceitam uma matriz que contém apenas um único valor.

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	pname não era um valor aceito.
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

Habilite e desabilite a neblina com glEnable e glDisable, usando o argumento GL_FOG. Enquanto habilitado, a neblina afeta a geometria rasterizada, bitmaps e blocos de pixel, mas não operações de limpeza de buffer.

A função glFogfv atribui o valor ou os valores em parâmetros ao parâmetro de neblina especificado por pname.

A neblina mistura uma cor de neblina com a cor pós-texto de cada fragmento de pixel rasterizado usando um fator de mesclagem f. O fator f é calculado de uma das três maneiras, dependendo do modo de neblina. Deixe z ser a distância nas coordenadas oculares da origem até o fragmento que está sendo fogged. A equação para GL_LINEAR neblina é:

A equação para GL_EXP neblina é:

A equação para GL_EXP2 neblina é:

Independentemente do modo de neblina, f é fixado ao intervalo [0,1] depois de computado. Em seguida, se OpenGL estiver no modo de cor RGBA, a cor do fragmento C_r será substituída por

No modo de índice de cores, o índice de cores do fragmento i_r é substituído por

As seguintes funções recuperam informações relacionadas às funções glFog :

glGet com GL_FOG_COLOR de argumento

glGet com GL_FOG_INDEX de argumento

glGet com GL_FOG_DENSITY de argumento

glGet com GL_FOG_START de argumento

glGet com GL_FOG_END de argumento

glGet com GL_FOG_MODE de argumento

glIsEnabled com GL_FOG de argumento

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

glDisable

glEnable

glEnd

glGet

glIsEnabled