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

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

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

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

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

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

<figure><img src="/files/L1sq0MvKqMBmwjrsyKwG" alt="" width="563"><figcaption></figcaption></figure>

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

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

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

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

<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="/files/SVChai6YAxN0STFLu2Th" alt="" width="563"><figcaption><p>Примеры настройки параметров освещения, содержащие цвет и его интенсивность</p></figcaption></figure>

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

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

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

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

![Рис.1](/files/niWkNNygAxMBcFJHbBrA)

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

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

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

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

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

<img src="/files/4q6EZaOLGPrQntA7TcOq" alt="Объекты для тестирования цвета" width="563">

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

<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="/files/7PiLyqlIStMHdiy0XHd4">/files/7PiLyqlIStMHdiy0XHd4</a></td><td><a href="/pages/tp7yRNwIWRdvHKuvuHei">/pages/tp7yRNwIWRdvHKuvuHei</a></td></tr><tr><td>Настройка пресета окружения</td><td>Инструкция</td><td></td><td><a href="/files/7PiLyqlIStMHdiy0XHd4">/files/7PiLyqlIStMHdiy0XHd4</a></td><td><a href="/pages/VbVFOGQemAeyvgKbuAbd">/pages/VbVFOGQemAeyvgKbuAbd</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bestway-1.gitbook.io/documentation/gem-rts-v1-ru/redaktor/redaktor-okruzheniya/obshaya-informaciya-pro-osveshenie.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.