Функция glDepthRange

Статья
06/13/2023

Функция glDepthRange определяет сопоставление значений z из нормализованных координат устройства в координаты окна.

Синтаксис

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

Параметры

zNear: Сопоставление ближней плоскости обрезки с координатами окна. Значение по умолчанию равно нулю.
zFar: Сопоставление дальней плоскости обрезки с координатами окна. Значение по умолчанию — 1.

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

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

Коды ошибок

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

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

После обрезки и деления по wz-координаты находятся в диапазоне от 0,0 до 1,0, что соответствует ближней и дальней плоскости отсечения. Функция glDepthRange задает линейное сопоставление нормализованных координат Z в этом диапазоне с координатами окна z. Независимо от фактической реализации буфера глубины значения глубины координат окна обрабатываются так, как будто они находятся в диапазоне от 0,0 до 1,0 (например, компоненты цвета). Таким образом, значения, принимаемые glDepthRange , прикрепляются к этому диапазону, прежде чем они будут приняты.

Сопоставление по умолчанию (0,1) сопоставляет ближней плоскости с 0, а дальнюю плоскость — с 1. При таком сопоставлении диапазон буфера глубины полностью используется.

Необязательно, чтобы zNear было меньше , чем zFar. Допустимы обратные сопоставления, такие как (1,0).

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

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

Требования

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

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

glBegin
glDepthFunc
glEnd
glGet
glViewport

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