Función glPolygonMode

La función glPolygonMode selecciona un modo de rasterización de polígonos.

Sintaxis

void WINAPI glPolygonMode(
   GLenum face,
   GLenum mode
);

Parámetros

Cara

Polígonos a los que se aplica el modo . Debe ser GL_FRONT para polígonos frontales, GL_BACK para polígonos orientados hacia atrás o GL_FRONT_AND_BACK para polígonos frontales y orientados hacia atrás.

mode

La forma en que se rasterizarán los polígonos. Se definen los siguientes modos y se pueden especificar en modo . El valor predeterminado es GL_FILL para polígonos frontales y posteriores.

Valor	Significado
GL_POINT	Los vértices de polígono marcados como el inicio de un borde de límite se dibujan como puntos. Los atributos de punto, como GL_POINT_SIZE y GL_POINT_SMOOTH, controlan la rasterización de los puntos. Los atributos de rasterización de polígonos distintos de GL_POLYGON_MODE no tienen ningún efecto.
GL_LINE	Los bordes de límite del polígono se dibujan como segmentos de línea. Se tratan como segmentos de línea conectados para el espumoso de línea; El contador de la esptippla de línea y el patrón no se restablecen entre segmentos (consulte glLineStipple). Los atributos de línea como GL_LINE_WIDTH y GL_LINE_SMOOTH controlan la rasterización de las líneas. Los atributos de rasterización de polígonos distintos de GL_POLYGON_MODE no tienen ningún efecto.
GL_FILL	El interior del polígono está lleno. Los atributos de polígono, como GL_POLYGON_STIPPLE y GL_POLYGON_SMOOTH, controlan la rasterización del polígono.

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	La cara o el modo 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

La función glPolygonMode controla la interpretación de polígonos para la rasterización. El parámetro face describe a qué modo de polígonos se aplica: polígonos frontales (GL_FRONT), polígonos orientados hacia atrás (GL_BACK) o ambos (GL_FRONT_AND_BACK). El modo de polígono afecta solo a la rasterización final de polígonos. En concreto, los vértices de un polígono se iluminan y el polígono se recorta y posiblemente se selecciona antes de aplicar estos modos.

Para dibujar una superficie con polígonos orientados hacia atrás rellenos y polígonos frontales resaltados, llame a

glPolygonMode(GL_FRONT, GL_LINE);

Los vértices se marcan como límites o no entrantes con una marca de borde. OpenGL genera internamente marcas perimetrales cuando descompone polígonos y se pueden establecer explícitamente mediante glEdgeFlag.

La siguiente función recupera información relacionada con glPolygonMode:

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

glEdgeFlag

glEnd

glLineStipple

glLineWidth

glPointSize

glPolygonStipple