Función glPolygonOffset

La función glPolygonOffset establece la escala y las unidades que OpenGL usa para calcular los valores de profundidad.

Sintaxis

void WINAPI glPolygonOffset(
   GLfloat factor,
   GLfloat units
);

Parámetros

factor

Especifica un factor de escala que se usa para crear un desplazamiento de profundidad variable para cada polígono. El valor inicial es cero.

Unidades

Especifica un valor multiplicado por un valor específico de la implementación para crear un desplazamiento de profundidad constante. El valor inicial es 0.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar el siguiente código de error.

Nombre	Significado
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

Cuando se habilita GL_POLYGON_OFFSET, el valor de profundidad de cada fragmento se desplazará después de que se interpole a partir de los valores de profundidad de los vértices adecuados. El valor del desplazamiento es factor * ?z + r *unidades, donde ?z es una medida del cambio en profundidad en relación con el área de pantalla del polígono, y r es el valor más pequeño que se garantiza para producir un desplazamiento resolvible para una implementación determinada. El desplazamiento se agrega antes de que se realice la prueba de profundidad y antes de que el valor se escriba en el búfer de profundidad.

La función glPolygonOffset es útil para representar imágenes de línea oculta, para aplicar calcales a superficies y para representar sólidos con bordes resaltados.

La función glPolygonOffset no tiene ningún efecto en las coordenadas de profundidad colocadas en el búfer de comentarios. Tampoco tiene ningún efecto en la selección.

Las siguientes funciones recuperan información relacionada con glPolygonOffset:

• glGet con GL_POLYGON_OFFSET_FACTOR de argumentos
• glGet con GL_POLYGON_OFFSET_UNITS de argumentos
• glIsEnabled con GL_POLYGON_OFFSET_FILL de argumentos
• glIsEnabled con GL_POLYGON_OFFSET_LINE de argumento
• glIsEnabled con GL_POLYGON_OFFSET_POINT de argumento

Nota

La función glPolygonOffset solo está disponible en openGl versión 1.1 o posterior.

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

glDepthFunc

glDisable

glEnable

glGet

glIsEnabled

glLineWidth

glStencilOp

glTexEnv