Função glPolygonStipple

A função glPolygonStipple define o padrão de stippling de polígono.

Sintaxe

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

Parâmetros

mask

Um ponteiro para um padrão de 32x32 stipple que será descompactado da memória da mesma forma que glDrawPixels descompacta pixels.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

O código de erro a seguir pode ser recuperado pela função glGetError .

Comentários

A função glPolygonStipple define o padrão de stippling de polígono. O stippling de polígono, como a linha stippling (consulte glLineStipple), mascara determinados fragmentos produzidos pela rasterização, criando um padrão. O stippling é independente da suavização do polígono.

O parâmetro mask é um ponteiro para um padrão de 32 x 32 stipple armazenado na memória, assim como os dados de pixel fornecidos para glDrawPixels com altura e largura iguais a 32, um formato de pixel de GL_COLOR_INDEX e o tipo de dados de GL_BITMAP. Ou seja, o padrão de stipple é representado como uma matriz de 32x32 de índices de cores de 1 bit empacotados em bytes não assinados. Os parâmetros da função glPixelStore , como GL_UNPACK_SWAP_BYTES e GL_UNPACK_LSB_FIRST, afetam o assembliing dos bits em um padrão stipple. No entanto, as operações de transferência de pixel (deslocamento, deslocamento e mapa de pixel) não são aplicadas à imagem de dica.

O stippling de polígono está habilitado e desabilitado com glEnable e glDisable, usando GL_POLYGON_STIPPLE de argumento. Se habilitado, um fragmento de polígono rasterizado com coordenadas de janela x_w e y_w será enviado para o próximo estágio de OpenGL se e somente se o (x_w mod 32)th bit na (y_w mod 32)th linha do padrão de dica for um. Quando o stippling de polígono está desabilitado, é como se o padrão de stipple fosse todos.

As seguintes funções recuperam informações relacionadas a glPolygonStipple:

glGetPolygonStipple

glIsEnabled com GL_POLYGON_STIPPLE de argumento

Requisitos

Confira também

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer