Функция glAlphaFunc

Статья
06/12/2023

Функция glAlphaFunc позволяет приложению задать функцию альфа-теста.

Синтаксис

void WINAPI glAlphaFunc(
   GLenum   func,
   GLclampf ref
);

Параметры

func

Функция альфа-сравнения. Ниже приведены принятые символические константы и их значения.

Значение	Значение
GL_NEVER	Никогда не проходит.
GL_LESS	Передает, если входящее альфа-значение меньше ссылочного значения.
GL_EQUAL	Передает, если входящее альфа-значение равно ссылочным значениям.
GL_LEQUAL	Передает, если входящее альфа-значение меньше или равно ссылочного значения.
GL_GREATER	Передает, если входящее альфа-значение больше ссылочного значения.
GL_NOTEQUAL	Передает, если входящее альфа-значение не равно ссылочным значениям.
GL_GEQUAL	Передает значение , если входящее альфа-значение больше или равно ссылочного значения.
GL_ALWAYS	Всегда проходит. Это значение по умолчанию.

ref

Ссылочные значения, с которым сравниваются входящие альфа-значения. Это значение зажимается в диапазоне от 0 до 1, где 0 представляет наименьшее возможное альфа-значение, а 1 — максимально возможное значение. Ссылка по умолчанию — 0.

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

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

Коды ошибок

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

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

Альфа-тест отбрасывает фрагменты в зависимости от результата сравнения альфа-значений входящих фрагментов и константного ссылочного значения. Функция glAlphaFunc указывает функцию reference и comparison. Сравнение выполняется только в том случае, если включено альфа-тестирование. (Дополнительные сведения о GL_ALPHA_TEST см. в разделе glEnable.)

Параметры func и ref определяют условия, при которых рисуется пиксель. Входящее альфа-значение сравнивается с ссылкой с помощью функции, заданной функцией func. Если сравнение проходит успешно, то входящий фрагмент рисуется при условии последующих тестов трафарета и буфера глубины. Если сравнение завершается сбоем, в элементе framebuffer в этом расположении пикселя не вносятся никакие изменения.

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

Альфа-тестирование выполняется только в режиме RGBA.

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

glGet с аргументом GL_ALPHA_TEST_FUNC

glGet с аргументом GL_ALPHA_TEST_REF

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

Требования

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

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

glBegin
glBlendFunc
glClear
glDepthFunc
GlEnable
glEnd
glGet
glIsEnabled
glStencilFunc