# Vegetation Tool

Vegetation Edit Tool — это утилита для создания и редактирования растительности. С его помощью можно добавлять, настраивать и удалять растительность на уровне.

## Кисти

Кисти – это настройки, определяющие, как и какая растительность будет нарисована. Кисти хранятся в отдельных файлах с расширением `.vbrush` в папках `environment\vegetation\brushes\`. Каждая кисть содержит набор вегетации и настройки для каждой вегетации.

### Загрузка кисти

Чтобы загрузить кисть, перетащите ее из папки `environment\vegetation\brushes` в AssetBrowser в окно Vegetation Edit Tool.&#x20;

### Создание кисти

Для создания собственной кисти  сначала нажмите на кнопку ![](https://2579590880-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FUUqnl7EAfeMt5F0uO9UR%2Fimage.png?alt=media\&token=4a58c82e-accf-44bf-92c1-093572b20f5c). Это действие создаст новую кисть, которая отобразится в списке кистей как "Unsaved brush".

Затем необходимо добавить вегетацию в эту кисть. Вегетация хранится в формате `.str` и находится в папках:

* environment/vegetation/creeper - Ползучие растения
* environment/vegetation/debris - Камни
* environment/vegetation/flower|flowers\_new - Цветы
* environment/vegetation/grass - Трава
* environment/vegetation/spiral - Растительности из [миров спирали](https://vedmak.fandom.com/wiki/%D0%A1%D0%BA%D0%B2%D0%BE%D0%B7%D1%8C_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F_%D0%B8_%D0%BF%D1%80%D0%BE%D1%81%D1%82%D1%80%D0%B0%D0%BD%D1%81%D1%82%D0%B2%D0%BE)
* environment/vegetation/trees - Деревья
* environment/vegetation/underwater - Подводная растительность
* environment/vegetation/vegetables - Овощи

Для добавления вегетации перетащите её из AssetBrowser в окно кисти. После того как вегетация добавлена в кисть, её можно [настроить](#nastroika-vegetacii) в зависимости от ваших требований.

Чтобы сохранить созданную кисть как отдельный файл, нажмите на ![](https://2579590880-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FS0uiGL8tKT5a0QTs82jZ%2Fimage.png?alt=media\&token=3ae5abee-fbf6-4afa-8200-0ec167c850e3). Кисть будет сохранена и появится в списке кистей с заданным вами именем.

{% hint style="info" %}
Сохраняйте свои кисти внутри папки вашего мода, по пути dlc/<название длс>/environment/vegetation/brushes/<ваше имя>/
{% endhint %}

### Клонирование кисти

Для клонирования кисти выберете кисть которую вы хотите клонировать и нажмите на ![](https://2579590880-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FSxwt7nVBtS6IdgLuLIzD%2Fimage.png?alt=media\&token=bced2f84-d89a-4e14-97c2-f00df7d8ddc3).

### Копирование кисти

Чтобы скопировать растительность в радиусе, выберите точку на уровне, где расположена растительность, которую вы хотите скопировать. Зажмите клавишу `Ctrl` и кликните по выбранной точке. Утилита автоматически скопирует всю растительность в пределах выбранного радиуса в новую кисть, которую вам необходимо сохранить.

Важно помнить, что растительность, скопированная в новую кисть будет без настроек, использованных при первоначальном рисовании вегетации в этой зоне. Все параметры растительности будут установлены по умолчанию, и вам потребуется настроить их заново.

### Блокировка кисти

Кисть можно заблокировать, чтобы упростить процесс добавления новой растительности. Когда кисть заблокирована, вся новая растительность, которую вы [копируете](#kopirovanie-kisti) путем нажатия клавиши `Ctrl`, будет добавляться не в новую кисть, а в заблокированную кисть.

Для блокировки кисти необходимо нажать на значок замка рядом с выбранной кистью. Обратите внимание, что одновременно может быть заблокирована только одна кисть.

## Вегетация

### Настройка вегетации

Есть три основных свойства, которые определяют, как будет рисоваться определенная вегетация. Эти параметры позволяют настроить плотность, базовый размер и вариации размера растительности.

<table><thead><tr><th width="64">№</th><th width="151">Название</th><th>Описание</th></tr></thead><tbody><tr><td>1</td><td>Radius scale</td><td>Определяет плотность размещения растительности. Чем выше значение, тем плотнее будет распределена растительность на выбранной области.</td></tr><tr><td>2</td><td>General scale</td><td>Определяет базовый размер каждой растительности.</td></tr><tr><td>3</td><td>Scale variation</td><td>Определяет вариацию размеров растительности. Размер каждого растения рассчитывается как базовый размер (general scale) плюс или минус значение в пределах scale variation. Например, если general scale равен 2, а scale variation равен 1, то размер каждого растения будет варьироваться от 1 до 3 (2 ± 1).</td></tr></tbody></table>

{% embed url="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FvPb6DiRajHJkKqcPZu34%2F2024-07-21%2019-16-13.mp4?alt=media&token=bd794f17-5ac1-4b9e-a21f-910096209031" %}

### Рисование вегетации

Чтобы начать рисование вегетации, выберите кисть из доступных. Затем просто начните рисовать по уровню, перемещая курсор с зажатой левой кнопкой мыши. Вы также можете рисовать отдельным растением, выбрав его внутри кисти.

Чтобы удалить вегетацию, выберите кисть и начните рисовать с зажатой клавишей `Shift`. Удаляться будут только те растения, которые есть в выбранной кисти.

{% hint style="info" %}
Если вам нужно удалить растительность, для которой у вас нет подходящей кисти, просто [скопируйте](#kopirovanie-kisti) её в новую кисть и затем удалите.
{% endhint %}

#### Режимы рисования

Вы можете рисовать вегетацию не только по террейну, но и по мешам. В зависимости от задачи вы можете выбрать один из трех режимов:&#x20;

* **Рисование по террейну (Terrain only):** В этом режиме трава и другая растительность рисуются по ландшафту террейна. Это стандартный режим для работы утилиты.
* **Рисование по мешу (Static mesh only):** Выбирая этот режим, вы сможете рисовать вегетацию только по коллизионным мешам. Это полезно, когда нужно добавить растительность на искусственные поверхности или объекты, такие как здания, мосты и другие структуры.
* **Рисование по мешу и террейну (Terrain and static mesh):** В этом режиме редактор позволяет рисовать вегетацию как по террейну, так и по мешам. Редактор автоматически переключает кисть между поверхностями.

{% embed url="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FCQ0uXbbmBbyy8L1h3Nf4%2F2024-07-21%2021-27-14.mp4?alt=media&token=8fd39db2-b43c-4e78-b007-964ee68a3a86" %}

### Рисование размера вегетации

Чтобы начать рисование размера вегетации, нажмите на кнопку "Paint size" и выберите кисть или конкретное растение внутри кисти. Начните рисовать, и размер растительности, находящейся в выбранной кисти, будет увеличиваться. Для уменьшения размера зажмите клавишу `Shift`.

Вы также можете отрегулировать силу изменения размера с помощью ползунка "Brush strength".

{% embed url="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FbNHP9vUm3ybx0JbbvnFY%2F2024-07-21%2017-25-31.mp4?alt=media&token=ebde2c2c-60d0-49d8-99d1-f863bdf6b297" %}

### Рисование положение вегетации

При работе с вегетацией вы можете столкнуться с ситуацией, когда растительность не корректно подстраивается под террейн во время его редактирования. Это может привести к тому, что деревья, кусты и другая растительность будут "летать" в воздухе или частично находиться внутри террейна. Для решения этой проблемы в утилите для рисования вегетации предусмотрена опция Paint alignment. Она позволяет перемещать всю вегетацию по  ландшафту к земле, обеспечивая корректное расположение объектов.

Чтобы начать рисование положения вегетации, нажмите на кнопку "Paint aligment" и выберите кисть или конкретное растение внутри кисти. Начните рисовать, и растительность, которая не прилагает к террейну, переместится под уровень террейна.

{% hint style="info" %}
Рисование положение учитывает [режим рисования](#rezhimy-risovaniya).
{% endhint %}

{% embed url="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2F4VwRr21JmEKnD8TyHIfu%2F2024-07-21%2018-05-32.mp4?alt=media&token=bbd609a1-3bf9-4922-8743-cc7c86cd728b" %}

### Редактирование экземпляра вегетации

Чтобы редактировать каждую отдельную вегетацию индивидуально, нажмите на кнопку "Pick sample", после чего вы сможете выбрать конкретную вегетацию, дерево или объект травы. Далее вы можете точечно редактировать выбранный объект, изменяя его размер, поворот или положение.

{% hint style="info" %}
Редактирование отдельного экземпляра вегетации не работает для [сгенерированой](#generaciya-vegetacii) травы.
{% endhint %}

{% embed url="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FFfqWGeEboyjz0vcWO7LV%2F2024-07-21%2020-39-55.mp4?alt=media&token=d216538d-d4b5-4654-bb59-d0c49cfe0733" %}

## Генерация вегетации

Генерация травы позволяет автоматически размещать растительность на террейне, зависимо от материала (текстуры) террейна.&#x20;

Для начала откройте Asset Browser и выберите кисть, после перейдите в Terrain Edit Tool и откройте вкладку Materials. В этой вкладке назначьте выбранную кисть нужному материалу террейна. После назначения кисти материалу террейна редактор автоматически разместит вегетацию по всей области, где используется данный материал.

### Маска травы

Маска травы позволяет контролировать, где на уровне будет генерироваться вегетация. По умолчанию, маска установлена глобально на весь уровень и позволяет сгенерированную траву по всему уровню.

Чтобы отредактировать маску травы, нажмите "Paint grass mask". Начните рисовать маску в тех местах, где не хотите видеть генерацию травы. По умолчанию рисуется маска, которая исключает генерацию травы. Если вы хотите включить генерацию травы в ранее отключенных областях, удерживайте клавишу `Shift`.

{% embed url="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKTpR2baZt07exAVMzmhU%2Fuploads%2FtvD3rLGwxRZfSuHqxlBa%2F2024-07-21%2020-31-08.mp4?alt=media&token=67d3b515-f77f-4e81-8fc9-60b39df54b94" %}

## Статистика

