Función glPolygonStipple
La función glPolygonStipple establece el patrón de acoplamiento poligonal.
Sintaxis
void WINAPI glPolygonStipple(
const GLubyte *mask
);
Parámetros
-
mask
-
Puntero a un patrón de esptippla de 32 x 32 que se desempaquetará de la memoria de la misma manera que glDrawPixels desempaqueta píxeles.
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
La función glPolygonStipple establece el patrón de acoplamiento poligonal. El stippling de polígonos, como el stippling de líneas (consulte glLineStipple), enmascara determinados fragmentos producidos por la rasterización, creando un patrón. Stippling es independiente del suavizado poligonal.
El parámetro mask es un puntero a un patrón de esptippla de 32x32 que se almacena en memoria igual que los datos de píxeles proporcionados a glDrawPixels con alto y ancho igual a 32, un formato de píxel de GL_COLOR_INDEX y el tipo de datos de GL_BITMAP. Es decir, el patrón de esptippla se representa como una matriz de 32x32 de índices de color de 1 bits empaquetados en bytes sin signo. Los parámetros de la función glPixelStore , como GL_UNPACK_SWAP_BYTES y GL_UNPACK_LSB_FIRST, afectan al montaje de los bits en un patrón de esptippla. Sin embargo, las operaciones de transferencia de píxeles (desplazamiento, desplazamiento y mapa de píxeles) no se aplican a la imagen de esptippla.
El stippling de polígonos está habilitado y deshabilitado con glEnable y glDisable, mediante GL_POLYGON_STIPPLE de argumentos. Si está habilitado, se envía un fragmento de polígono rasterizado con coordenadas de ventana xw e yw a la siguiente fase de OpenGL si y solo si el bit (xw mod 32)th en la fila (yw mod 32)ésima fila del patrón de esptippla es uno. Cuando el espaciado de polígono está deshabilitado, es como si el patrón de esptippla fuera todos.
Las siguientes funciones recuperan información relacionada con glPolygonStipple:
glIsEnabled con GL_POLYGON_STIPPLE de argumento
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 |
|