# Настройка параметров ветра

## Чувствительность объекта к ветру

### Параметр чувствительности к ветру

Для настройки чувствительности объектов сцены к ветру используется параметр `wind_sensibility`. \
Его значение задается в файлах конфигурации следующим образом:

```plaintext
{wind_sensibility X}
```

где `X` — степень чувствительности к ветру :

* `X=0` — ветер выключен (используется по умолчанию);
* `X=1` — низкая чувствительность (например, для деревьев);
* `X=3` — высокая чувствительность (например, для травы).

### Настройка чувствительности к ветру

Параметр чувствительности к ветру `wind_sensibility` задается в следующих файлах:

* `properties/tree.inc` — для деревьев;
* `properties/bush.inc` — для кустов;
* `properties/grass.inc` — для травы;
* `.def` файл конкретного объекта.

Для отключения чувствительности объекта к ветру можно использовать свойство `"no_wind"` в разделе `props`.

### Управление реакцией объекта на ветер в скриптах

Реакцией объекта на ветер в процессе игры можно управлять с помощью скриптов, описанных в файлах из папки `scene\set\interaction_entity`. 

<details>

<summary>Пример управления реакцией объекта на ветер с помощью скриптов</summary>

```
{on "update_wind"
        {if flag "bare"
            {depend_on_wind 0}
        else fallen
            {depend_on_wind 0}
        else
            {depend_on_wind 1}
        }
    }
```

Отключение реакции объекта на ветер `{depend_on_wind 0}`

</details>

## Настройка параметров ветра

Основные параметры ветра настраиваются в файле конфигурации `main/scene/set/wind.set`.

**Описание параметров ветра**

<table><thead><tr><th width="352">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><code>global_wind_speed</code></td><td>Указывает скорость анимации текстуры порывов ветра, измеряется в единицах перемещения за кадр.</td></tr><tr><td><code>tree_bend_offset</code></td><td>Определяет базовый угол отклонения деревьев в направлении ветра без учета порывов, измеряется в градусах.</td></tr><tr><td><code>tree_bend_range</code></td><td>Задает максимальный диапазон отклонения деревьев во время порывов ветра, измеряется в градусах.</td></tr><tr><td><code>grass_bend_gust_start</code></td><td>Устанавливает минимальный порог порыва ветра для анимации травы, диапазон значений [-1..1]. </td></tr><tr><td><code>grass_bend_gust_end</code></td><td>Устанавливает максимальный порог порыва ветра для анимации травы, диапазон значений [-1..1]. <br>Значение данного параметра должно быть больше значения параметра <code>grass_bend_gust_start</code>.</td></tr><tr><td><code>grass_bend_angle_offset</code></td><td>Указывает базовый угол отклонения травы в направлении ветра без учета порывов, измеряется в градусах.</td></tr><tr><td><code>grass_bend_angle_range</code></td><td>Определяет диапазон отклонения травы во время порывов ветра, измеряется в градусах. <br>Следует избегать значений, которые визуально погружают траву под землю.</td></tr><tr><td><code>grass_bend_angle_power</code></td><td>Управляет амплитудой колебаний травы в направлении ветра во время порывов, измеряется в градусах.</td></tr><tr><td><code>grass_bend_angle_freq</code></td><td>Определяет частоту колебаний травы в направлении ветра во время порывов, измеряется в условных единицах.</td></tr><tr><td><code>grass_large_scale_power</code></td><td>Настраивает интенсивность крупных волновых колебаний травы в отсутствие порывов, диапазон значений [0..1].</td></tr><tr><td><code>grass_large_scale_gust_power</code></td><td>Настраивает интенсивность крупных волновых колебаний травы в условиях максимального порыва ветра, диапазон значений [0..1].</td></tr><tr><td><code>grass_large_scale_freq</code></td><td>Определяет частоту крупных волновых колебаний травы, измеряется в условных единицах.</td></tr><tr><td><code>grass_small_scale_power</code></td><td>Настраивает интенсивность мелких волновых колебаний травы в отсутствие порывов, диапазон значений [0..1].</td></tr><tr><td><code>grass_small_scale_gust_power</code></td><td>Настраивает интенсивность мелких волновых колебаний травы в условиях максимального порыва ветра, диапазон значений [0..1].</td></tr><tr><td><code>grass_small_scale_freq</code></td><td>Определяет частоту мелких волновых колебаний травы, измеряется в условных единицах.</td></tr></tbody></table>

**Рекомендуемый порядок настройки параметров ветра**

1. Задаются значения для параметра `global_wind_speed` ;
2. Задаются параметры ветра для деревьев `tree_bend_offset`, `tree_bend_range`;
3. Параметры для травы:
   * `grass_bend_gust_start`, `grass_bend_gust_end`;
   * `grass_bend_angle_offset`, `grass_bend_angle_range`;
   * `grass_bend_angle_freq`, `grass_bend_angle_power`;
   * `grass_large_scale_*`, `grass_small_scale_*`.

<details>

<summary>Пример настройки параметров ветра</summary>

Каждый элемент настраивается для различных значений ветра по шкале от 0 до 10. \
Если значения пропущены, то они вычисляются путем интерполяции:

```plaintext
{grass_small_scale_power 
     0 0.004   ; штиль
     1 0.010
     10 0.100  ; ураган
}
```

</details>

## Консольные команды

Для диагностики и управления ветром в игре доступны следующие консольные команды:

* Перезагрузить настройки ветра из файла `wind.set`:

  ```plaintext
  ed_reloadWind
  ```
* Отобразить на экране чувствительность объектов к ветру:&#x20;

  ```plaintext
  v_entityWind [0|1]
  ```

<figure><img src="/files/KmL6kgzTbSGMGSKh96PI" alt=""><figcaption><p>Отображение чувствительности объектов на экране с помощью команды v_entityWind</p></figcaption></figure>


---

# 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/dokumentaciya/nastroiki-igrovykh-parametrov/nastroika-parametrov-vetra.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.