Função glPolygonOffset

A função glPolygonOffset define a escala e as unidades que o OpenGL usa para calcular valores de profundidade.

Sintaxe

void WINAPI glPolygonOffset(
   GLfloat factor,
   GLfloat units
);

Parâmetros

factor

Especifica um fator de escala usado para criar um deslocamento de profundidade variável para cada polígono. O valor inicial é zero.

Unidades

Especifica um valor multiplicado por um valor específico da implementação para criar um deslocamento de profundidade constante. O valor inicial é 0.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

O código de erro a seguir pode ser recuperado pela função glGetError .

Nome Significado
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

Quando GL_POLYGON_OFFSET estiver habilitado, o valor de profundidade de cada fragmento será deslocado depois de ser interpolado dos valores de profundidade dos vértices apropriados. O valor do deslocamento é fator * ?z + r *units, em que ?z é uma medida da alteração em profundidade em relação à área de tela do polígono, e r é o menor valor que é garantido para produzir um deslocamento resolvível para uma determinada implementação. O deslocamento é adicionado antes que o teste de profundidade seja executado e antes que o valor seja gravado no buffer de profundidade.

A função glPolygonOffset é útil para renderizar imagens de linha oculta, para aplicar decalques a superfícies e para renderizar sólidos com bordas realçadas.

A função glPolygonOffset não tem efeito sobre as coordenadas de profundidade colocadas no buffer de comentários. Ele também não tem efeito sobre a seleção.

As seguintes funções recuperam informações relacionadas ao glPolygonOffset:

  • glGet com GL_POLYGON_OFFSET_FACTOR de argumento
  • glGet com GL_POLYGON_OFFSET_UNITS de argumento
  • glIsEnabled com GL_POLYGON_OFFSET_FILL de argumento
  • glIsEnabled com GL_POLYGON_OFFSET_LINE de argumento
  • glIsEnabled com GL_POLYGON_OFFSET_POINT de argumento

Observação

A função glPolygonOffset só está disponível no OpenGl versão 1.1 ou superior.

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

glDepthFunc

glDisable

glEnable

glGet

glIsEnabled

glLineWidth

glStencilOp

glTexEnv