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
GL_INVALID_OPERATION	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 x_w e y_w a la siguiente fase de OpenGL si y solo si el bit (x_w mod 32)th en la fila (y_w 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:

glGetPolygonStipple

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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer