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 |
|---|---|
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|