Q2PRO-X 1.4 - руководство по HDR

HDR-рендер, true HDR output, WGL/EGL и настройка яркости

Q2PRO-X 1.4
5 июля 2026

Что такое HDR в Q2PRO-X

В 1.4 HDR разделён на две части. gl_hdr включает внутренний HDR-рендер: сцена считается в расширенном диапазоне, затем проходит tone mapping, bloom и финальный вывод. gl_hdr_output включает настоящий HDR-сигнал на дисплей, когда backend и Windows/display path это позволяют. Можно использовать внутренний HDR без настоящего HDR-дисплея, но максимальный эффект виден при gl_hdr 1 + gl_hdr_output 1 + HDR-дисплей.

Для лучшего HDR-эффекта рекомендуется backend win32wgl. win32egl тоже умеет HDR output, но на Windows зависит от включенного HDR в настройках Windows и имеет отдельную EGL-калибровку gl_hdr_egl_app_white_max.

Быстрая настройка

В Windows включите HDR для монитора.
В Q2PRO-X выберите win32wgl, если хотите максимум HDR-эффекта и драйвер нормально работает с WGL.
Откройте карту. Для WGL HDR output надёжнее проверять именно после загрузки карты, потому что часть display path становится очевидной только на реальном рендере.
В меню откройте Video and Display -> HDR Settings или выполните /HDR.
Включите HDR rendering = Auto, HDR display output = On, HDR output mode = Extended highlights.
Установите Paper white под комфорт обычного белого, обычно 160..250 нит.
Установите Peak brightness под монитор, например 1000, 1300 или 1600 нит.
Выполните gl_hdr_info и проверьте, что backend, scene format и output path выглядят ожидаемо.

Пример для дисплея 1300 нит:

vid_driver win32wgl
gl_hdr 1
gl_hdr_output 1
gl_hdr_output_mode 1
gl_hdr_paper_white_nits 200
gl_hdr_peak_nits 1300
gl_hdr_tonemap 2
gl_hdr_info

Основные параметры

Cvar	Что делает	Практический совет
`gl_hdr`	Внутренний HDR-рендер. 0 off, 1 auto, 2 force.	Обычно `1`. `2` нужен для диагностики.
`gl_hdr_output`	Настоящий HDR-сигнал на монитор.	Включайте только с HDR-дисплеем и HDR в Windows.
`gl_hdr_output_mode`	Paper-white parity или extended highlights.	Для реального HDR эффекта используйте `Extended highlights`.
`gl_hdr_scene_format`	Формат HDR scene buffer.	`Auto` выбирает лучший поддержанный путь.
`gl_hdr_tonemap`	Сжатие переярких значений к дисплею.	`ACES` - хороший общий выбор.
`gl_hdr_peak_nits`	Пиковая яркость дисплея.	Ставьте под реальный peak монитора.
`gl_hdr_paper_white_nits`	Яркость обычного белого.	200 - хороший старт; ниже темнее SDR-база, выше ярче UI/сцена.
`gl_hdr_egl_app_white_max`	Только `win32egl`: app-side cap белого.	Default 1.1. Ниже защищает лампы/луну/солнце от пересвета, выше делает EGL ярче. WGL игнорирует.
`gl_hdr_exposure`	Ручная компенсация сцены в EV.	Используйте тонко, после paper white/peak.
`gl_hdr_bloom_threshold_nits`	Порог HDR bloom.	Ниже - больше сияния; выше - только самые яркие источники.
`gl_hdr_emissive_peak_scale`	Пик эмиссивного света карты.	Полезно для ламп/спавнов/ярких источников.
`gl_hdr_celestial_peak_scale`	Пик солнца/луны/неба.	Управляет небесным HDR-эффектом.
`gl_hdr_fx_peak_scale`	Пик молний и AVFX FX.	Повышайте для ярких гроз/метеоров.
`gl_hdr_debug`	Диагностика HDR.	`Clip mask` помогает увидеть пересвет.

WGL и EGL

win32wgl - основной рекомендуемый путь для настоящего HDR. Он даёт более прямой OpenGL display path на современных драйверах и обычно лучше сохраняет яркие пики без потери деталей.

win32egl - полезен для производительности и ANGLE/D3D11 compatibility path. Для HDR output ему нужен включенный HDR в Windows. Из-за отличий swapchain/color space EGL может требовать отдельной подстройки gl_hdr_egl_app_white_max. Default 1.1 выбран как компромисс: он защищает детали ламп/солнца/луны лучше старого поведения, но не делает картинку слишком тусклой.

Если на EGL яркие источники превращаются в белые пятна:

Оставьте gl_hdr_peak_nits и gl_hdr_paper_white_nits как на WGL.
Понижайте gl_hdr_egl_app_white_max шагами 0.05: 1.10 -> 1.05 -> 1.00.
Если картинка стала слишком тусклой, верните 1.10 или слегка поднимите exposure.
Для финальной красивой HDR-картинки используйте WGL, если нет причин оставаться на EGL.

HDR-пресеты AVFX

HDR-пресеты находятся в AVFX Presets -> HDR (High Dynamic Range). Они рассчитаны на включенный gl_hdr. Музыкальные варианты останавливают текущую online music композицию и запускают свою. Не музыкальные варианты меняют только визуальный профиль.

Скриншоты HDR

Для обычного сравнения SDR достаточно screenshotjpg. Для настоящего HDR используйте:

screenshotjxr
screenshotjxr_raw

JXR нужен для сохранения расширенного диапазона. JPG может выглядеть нормально как иллюстрация, но не является проверкой HDR-данных. Проверять качество HDR нужно глазами на HDR-дисплее и через gl_hdr_info/debug modes.

Типовые проблемы

Нет HDR-эффекта: проверьте Windows HDR, gl_hdr_output 1, backend и загрузку карты.
Сцена похожа на SDR: включите Extended highlights, проверьте peak/paper white и используйте WGL.
Лампы/луна/солнце клиппятся в EGL: уменьшите gl_hdr_egl_app_white_max.
UI или обычный белый слишком яркий: уменьшите gl_hdr_paper_white_nits.
Всё слишком тёмное: сначала поднимите paper white, потом осторожно exposure.