> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/gem-rts-v1-ru/redaktor/redaktor-okruzheniya/obshaya-informaciya-pro-osveshenie.md).

# Общая информация про освещение

{% hint style="info" %}
Открыть окно Редактора окружения можно клавишей F6
{% endhint %}

### Основные компоненты освещения для корректной работы HDR

Для корректной работы HDR в настройках пресета окружения обязательно должны быть включены ниже перечисленные секции

* `eye_adapation` - enabled
* `tone_mapping` - enabled
* `tone_mapping` - aces

Основным параметром HDR является `target_exposure` в блоке параметров для `eye_adapation`

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FtinbjlTVQ5bioRVkx8oh%2FEnvironment%20Editor.png?alt=media&amp;token=85c6e1ca-2c07-4810-8c80-bfda91bab52a" alt="" width="563"><figcaption></figcaption></figure>

## Условия корректной работы HDR <a href="#id-1u8163ry2lgp" id="id-1u8163ry2lgp"></a>

Для корректной работы HDR нужно иметь свет в разных диапазонах яркости, чтобы яркости на экране различались в 5-10 раз минимум.

Рабочий диапазон 0.001 \~ 10.

### Компоненты освещения

<table><thead><tr><th width="263">Компонент</th><th>Описание</th></tr></thead><tbody><tr><td>light/<code>ambient_intensity</code></td><td>Интенсивность окружающего освещения, равномерно распространяющегося по всей сцене.</td></tr><tr><td>light/<code>diffuse_intensity</code></td><td>Интенсивность рассеянного освещения, определяющая яркость поверхностей, направленных к источнику света.</td></tr><tr><td>light/<code>envmap_amount</code></td><td>Количество отраженного света от окружающей карты окружения, используемое для создания отражений.</td></tr><tr><td>light/<code>environment_intensity</code></td><td>Интенсивность освещения от окружающей среды, включая естественное и отраженный свет.</td></tr><tr><td>haze/<code>intensity</code></td><td>Интенсивность дымки или тумана, добавляющая атмосферный эффект и изменяющая видимость сцены.</td></tr><tr><td>HDR текстуры неба</td><td>Использование высокодинамичных текстур для неба для достижения реалистичного отображения световых переходов.</td></tr><tr><td>Квадратичное затухание на источниках света</td><td>Формула затухания света, создающая реалистичное распределение света с увеличением расстояния.</td></tr><tr><td>Характерные спекуляры для всех материалов</td><td>Настройка спекулярных свойств всех материалов, добавляющая блики и отраженный свет</td></tr></tbody></table>

### Уровни яркости в реальной жизни <a href="#elpavu7nyl6k" id="elpavu7nyl6k"></a>

<table><thead><tr><th>Параметр</th><th width="205">Интенсивность света</th><th>Описание</th></tr></thead><tbody><tr><td>candle</td><td>10</td><td>Имитация света от свечи, создающая уютную атмосферу</td></tr><tr><td>cloud_at_night</td><td>0.00033</td><td>Тусклое освещение при облачном ночном небе</td></tr><tr><td>cloud_at_night (lit by moon)</td><td>0.0419</td><td>Облачное ночное небо, освещённое луной</td></tr><tr><td>frosted_bulb_60w</td><td>1200</td><td>Свет от матовой лампы на 60 ватт</td></tr><tr><td>monitor</td><td>3</td><td>Имитация света от экрана монитора</td></tr><tr><td>moon_surface</td><td>30</td><td>Свет, имитирующий освещённость поверхности луны</td></tr><tr><td>sky_cloudy</td><td>20</td><td>Свет в пасмурный день</td></tr><tr><td>sky_day</td><td>60</td><td>Яркий солнечный свет днём</td></tr><tr><td>sky_night (lit by moon)</td><td>0.00085</td><td>Ночной свет при освещении луной</td></tr><tr><td>sky_night_dark</td><td>4e-006</td><td>Очень тусклое ночное освещение</td></tr><tr><td>sky_night_noon</td><td>0.00124</td><td>Ночное освещение без дополнительных источников света</td></tr><tr><td>sky_rise_skyline</td><td>0.0019</td><td>Рассвет или закат</td></tr><tr><td>star</td><td>0.00196</td><td>Свет от далёкой звезды</td></tr></tbody></table>

{% hint style="info" %}
Итоговый цвет для параметров освещения, содержащие в себе интенсивность intensity (например, light/`ambient`, light/`diffuse`, haze/`color` и другие) рассчитывается по формуле:

```
result_color = color * intensity
```

Таким образом итоговая яркость зависит от яркости самого цвета и параметра `intensity`
{% endhint %}

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FIZVoZ295crxTFIwRROj1%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-05-16%20%D0%B2%2017.10.57.png?alt=media&amp;token=ea55440d-4095-47c5-979c-a60d8bfe64d6" alt="" width="563"><figcaption><p>Примеры настройки параметров освещения, содержащие цвет и его интенсивность</p></figcaption></figure>

## **Настройки tonemapper**

{% hint style="info" %}
Настройки tonemapper должны быть одни на весь проект
{% endhint %}

Если вам нужен специфический вид кадра - используйте LUT

Для понимания работы адаптации и HDR очень полезно с помощью консоли включить отображение кривых для параметров HDR.\
Для этого ведите в консоль команду `v_hdrHistogramOn 1`

![Рис.1](https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FxUMI8YnsXz0ZM2ewLRgV%2F1.png?alt=media)

Расшифровка рисунка 1:

* Красная линия - кривая tonemapping (вычисляется автоматически по самой tonemapping формуле и её параметрам)
* Желтая линия - выбранное автоэкспозицией значение яркости
* Зеленые линии - `exposure_min`, `exposure_max`
* Синие линии - отсчёты яркости по горизонтали

## Объекты для тестирования цвета

Для проверки цветов в ресурсах игры есть 3 тестовых объекта, которые находятся в папке **service** редактора Entity \[1]:

1. color\_checker\_gradient - для проверки отображения монохромных градиентов
2. color\_checker\_kodak - для проверки яркостей
3. color\_checker - для проверки передачи стандартных оттенков

![Объекты для тестирования цвета](https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FtbM5I0ZJrOfOUXeLYtcg%2F2.png?alt=media)

Узнайте больше о создании и настройке параметров окружения

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Создание пресета окружения</td><td>Инструкция о том, как создать пресет окружения с нуля</td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FrCk1dAvSKKe04Fp9WkP4%2Fsplash_editor_3.jpg?alt=media&amp;token=a89d5e03-56d3-401d-b04b-8da366458bd9">cover picture default</a></td><td><a href="/gem-rts-v1-ru/redaktor/redaktor-okruzheniya/sozdanie-svoego-preseta-environment.md">Создание пресета Environment</a></td></tr><tr><td>Настройка пресета окружения</td><td>Инструкция</td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FrCk1dAvSKKe04Fp9WkP4%2Fsplash_editor_3.jpg?alt=media&amp;token=a89d5e03-56d3-401d-b04b-8da366458bd9">cover picture default</a></td><td><a href="/gem-rts-v1-ru/redaktor/redaktor-okruzheniya/nastroi-ka-environment.md">Настройка Environment</a></td></tr></tbody></table>