Функция glPolygonOffset

Статья
06/13/2023

Функция glPolygonOffset задает масштаб и единицы, которые OpenGL использует для вычисления значений глубины.

Синтаксис

void WINAPI glPolygonOffset(
   GLfloat factor,
   GLfloat units
);

Параметры

Фактор: Задает коэффициент масштабирования, используемый для создания переменной смещения глубины для каждого многоугольника. Начальное значение равно нулю.
Единиц: Задает значение, умноженное на значение для конкретной реализации для создания смещения константы глубины. Начальное значение равно 0.

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

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

Коды ошибок

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

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

Если включена GL_POLYGON_OFFSET, значение глубины каждого фрагмента будет смещено после интерполяции из значений глубины соответствующих вершин. Значение смещения — коэффициент * ?z + r *единицы, где ?z — это измерение изменения глубины относительно области экрана многоугольника, а r — наименьшее значение, гарантированное для создания разрешаемого смещения для данной реализации. Смещение добавляется перед выполнением теста глубины и перед записью значения в буфер глубины.

Функция glPolygonOffset полезна для отрисовки изображений со скрытыми линиями, для применения наклеек к поверхностям и для отрисовки твердых элементов с выделенными краями.

Функция glPolygonOffset не влияет на координаты глубины, размещенные в буфере обратной связи. Это также не влияет на выбор.

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

glGet с аргументом GL_POLYGON_OFFSET_FACTOR
glGet с аргументом GL_POLYGON_OFFSET_UNITS
glIsEnabled с аргументом GL_POLYGON_OFFSET_FILL
glIsEnabled с аргументом GL_POLYGON_OFFSET_LINE
glIsEnabled с аргументом GL_POLYGON_OFFSET_POINT

Примечание

Функция glPolygonOffset доступна только в OpenGl версии 1.1 или более поздней.

Требования

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

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

glDepthFunc
glDisable
GlEnable
glGet
glIsEnabled
glLineWidth
glStencilOp
glTexEnv

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