Função glPolygonMode

A função glPolygonMode seleciona um modo de rasterização de polígono.

Sintaxe

void WINAPI glPolygonMode(
   GLenum face,
   GLenum mode
);

Parâmetros

Cara

Os polígonos aos quais o modo se aplica. Deve ser GL_FRONT para polígonos frontais, GL_BACK para polígonos voltados para trás ou GL_FRONT_AND_BACK para polígonos voltados para frente e para trás.

mode

A maneira como os polígonos serão rasterizados. Os modos a seguir são definidos e podem ser especificados no modo . O padrão é GL_FILL para polígonos voltados para frente e para trás.

Valor	Significado
GL_POINT	Os vértices polígonos marcados como o início de uma borda de limite são desenhados como pontos. Atributos de ponto, como GL_POINT_SIZE e GL_POINT_SMOOTH controlar a rasterização dos pontos. Atributos de rasterização de polígono diferentes de GL_POLYGON_MODE não têm efeito.
GL_LINE	As bordas de limite do polígono são desenhadas como segmentos de linha. Eles são tratados como segmentos de linha conectados para stippling de linha; o contador de dica de linha e o padrão não são redefinidos entre segmentos (consulte glLineStipple). Atributos de linha, como GL_LINE_WIDTH e GL_LINE_SMOOTH controlar a rasterização das linhas. Atributos de rasterização de polígono diferentes de GL_POLYGON_MODE não têm efeito.
GL_FILL	O interior do polígono é preenchido. Atributos de polígono, como GL_POLYGON_STIPPLE e GL_POLYGON_SMOOTH controlar a rasterização do polígono.

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	O rosto ou o modo 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

A função glPolygonMode controla a interpretação de polígonos para rasterização. O parâmetro face descreve a qual modo de polígonos se aplica: polígonos frontais (GL_FRONT), polígonos voltados para trás (GL_BACK) ou ambos (GL_FRONT_AND_BACK). O modo polígono afeta apenas a rasterização final dos polígonos. Em particular, os vértices de um polígono são iluminados e o polígono é recortado e possivelmente abatido antes que esses modos sejam aplicados.

Para desenhar uma superfície com polígonos voltados para trás e polígonos frontais delineados, chame

glPolygonMode(GL_FRONT, GL_LINE);

Os vértices são marcados como limite ou não associados com um sinalizador de borda. Os sinalizadores de borda são gerados internamente pelo OpenGL quando ele decompõe polígonos e eles podem ser definidos explicitamente usando glEdgeFlag.

A função a seguir recupera informações relacionadas a glPolygonMode:

glGet com GL_POLYGON_MODE 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

glEdgeFlag

glEnd

glLineStipple

glLineWidth

glPointSize

glPolygonStipple