Функция glPolygonStipple

Статья
06/13/2023

Функция 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

Поделиться через