Функция glLineStipple

  • Статья

Функция glLineStipple задает шаблон стипа линий.

Синтаксис

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

Параметры

Фактор

Множитель для каждого бита в шаблоне прогона строки. Например, если коэффициент равен 3, каждый бит в шаблоне будет использоваться три раза перед использованием следующего бита в шаблоне. Параметр factor зажимается в диапазоне [1, 256] и по умолчанию имеет значение 1.

pattern

16-разрядное целое число, битовое узор которого определяет, какие фрагменты линии будут нарисованы при растеризации линии. Сначала используется ноль битов, а по умолчанию используется шаблон по умолчанию.

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

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

Коды ошибок

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

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

Комментарии

Функция glLineStipple задает шаблон стипа линий. Стипплинг линий маскирует определенные фрагменты, созданные растеризацией; эти фрагменты не будут нарисованы. Маскирование достигается с помощью трех параметров: шаблона 16-разрядной строчки, коэффициента счетчика повторений и целочисленного счетчика stipple s.

Значение счетчика сбрасывается до нуля при каждом вызове glBegin и перед каждым сегментом строки последовательности glBegin(GL_LINES)/glEnd . Он увеличивается после создания каждого фрагмента фрагмента линии с псевдонимом ширины единицы или после создания каждого фрагмента i ширины линии. Фрагменты i, связанные с числом s, маскируются, если бит шаблона (s-фактор / ) mod 16 равен нулю. В противном случае эти фрагменты отправляются в framebuffer. Бит ноль шаблона является наименее значимым битом.

Сглаживаемые линии обрабатываются как последовательность прямоугольниковшириной 1x для целей стирания. Прямоугольники растеризованы или не основаны на правиле фрагмента, описанном для линий с псевдонимами; он подсчитывает прямоугольники, а не группы фрагментов.

Стипплинг строк включается или отключается с помощью glEnable и glDisable с аргументом GL_LINE_STIPPLE. Если этот параметр включен, шаблон стипа строк применяется, как описано выше. Если этот параметр отключен, это как если бы шаблон был всем. Изначально стиплинг строк отключен.

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

glGet с GL_LINE_STIPPLE_PATTERN аргументов

glGet с GL_LINE_STIPPLE_REPEAT аргументов

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

Требования

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

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

glBegin

glEnd

glLineWidth

glPolygonStipple