Функция glPolygonStipple

Функция glPolygonStipple задает шаблон многоугольника.

Синтаксис

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

Параметры

mask

Указатель на шаблон прогиба 32x32, который будет распаковыван из памяти так же, как glDrawPixels распаковывает пиксели.

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

Следующий код ошибки может быть получен функцией glGetError .

Имя	Значение
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Комментарии

Функция glPolygonStipple задает шаблон многоугольника. Многоугольник, как и стиплинг линий (см. glLineStipple), маскирует определенные фрагменты, созданные растеризацией, создавая шаблон. Стиплинг не зависит от сглаживания многоугольников.

Параметр mask — это указатель на шаблон стипа 32x32, который хранится в памяти точно так же, как и пиксельные данные, предоставляемые glDrawPixels , с высотой и шириной равными 32, форматом пикселей GL_COLOR_INDEX и типом данных GL_BITMAP. То есть шаблон стипа представлен в виде массива 32x32 1-разрядных цветовых индексов, упакованных в байты без знака. Параметры функции glPixelStore , такие как GL_UNPACK_SWAP_BYTES и GL_UNPACK_LSB_FIRST, влияют на сборку битов в шаблон прописи. Однако операции передачи пикселей (сдвиг, смещение и карта пикселей) не применяются к изображению с заглушить.

Многоугольник включается и отключается с помощью glEnable и glDisable, используя аргумент GL_POLYGON_STIPPLE. Если этот параметр включен, фрагмент растрового многоугольника с координатами окна x_w и y_w отправляется на следующий этап OpenGL, если и только если бит (x_w mod 32)th в строке (y_{w mod} 32)th шаблона прописи является одним. Когда многоугольник отключается, это как если бы шаблон стипа был всем.

Следующие функции извлекают сведения, связанные с glPolygonStipple:

glGetPolygonStipple

glIsEnabled с аргументом GL_POLYGON_STIPPLE

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Gl.h
Библиотека	Opengl32.lib
DLL	Opengl32.dll

См. также раздел

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer