> 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-kart/redaktor-landshafta/redaktor-foliage.md).

# Редактор Foliage

Cтатья охватывает основные аспекты использования инструмента Foliage Tools

**Редактор Foliage** \[`Foliage`] — это набор инструментов [Редактора ландшафта](/gem-rts-v1-ru/redaktor/redaktor-kart/redaktor-landshafta.md), предназначенный для автоматизированного размещения объектов игрового мира.\
Кисть Foliage позволяет легко и быстро создавать реалистичные и оптимизированные пейзажные сцены. Параметры кисти позволяют настроить состав кисти, а также плотность, масштаб, угол наклона и другие характеристики для входящих в кисть объектов, что даёт полный контроль над размещением объектов при наполнении сцены.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FmKORhAUroFOiIGDh3PbF%2Ffoliage.png?alt=media&amp;token=62f5a38f-bcfd-4373-b817-aa7231e03817" alt=""><figcaption><p>Редактор Foliage</p></figcaption></figure>

## Элементы интерфейса

* [Главное меню](#glavnoe-menyu) \[1]
* [Базовые настройки кисти](#bazovye-nastroiki-kisti) \[2]
* [Список объектов загруженной кисти](#spisok-obektov-zagruzhennoi-kisti) \[3]
* [Окно свойств](#okno-svoistv) выделенного объекта в списке кисти \[4]

## Главное меню

Главное меню вкладки **Foliage \[1]** предоставляет базовые функции для работы с кистями. Возможно загружать ранее сохраненные кисти, сохранять текущие настройки или создавать новые кисти на основе уже существующих.

<table data-header-hidden><thead><tr><th width="204">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><strong>Load</strong></td><td>Загрузка ранее сохраненной кисти</td></tr><tr><td><strong>Save</strong></td><td>Сохранение текущей кисти</td></tr><tr><td><strong>Save As</strong></td><td>Пересохранение текущей кисти в новый файл или создание новой</td></tr></tbody></table>

## Базовые настройки кисти

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

<table><thead><tr><th width="196">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><strong>Brush File</strong></td><td>Имя файла с относительным путем к кисти</td></tr><tr><td><strong>Brush Size</strong></td><td>Определяет размер кисти в пределах [0.0-3000.0]</td></tr><tr><td><strong>Paint Density</strong></td><td>Плотность объектов при рисовании, общий множитель для каждого активного объекта в пределах [0.0-1.0]</td></tr><tr><td><strong>Landscape</strong></td><td>Флажок управления разрешением размещать объекты на ландшафте</td></tr><tr><td><strong>Static Meshes</strong></td><td>Флажок управления разрешением размещать объекты на поверхностях статических объектов сцены</td></tr><tr><td><strong>Foliage</strong></td><td>Флажок управления разрешением размещать объекты на других объектах</td></tr></tbody></table>

{% hint style="warning" %}
Флажок **Landscape** активирован по умолчанию.\
Переключение состояния флажков **Landscape**, **Static Meshes** и **Foliage** временно отключено.
{% endhint %}

## Список объектов загруженной кисти

**Список объектов \[2]** - Окно \[-Foliage List-] содержит список объектов, которые могут быть размещены в сцене с использованием загруженной кисти.\
С помощью кнопок управления можно добавлять новые объекты в список, удалять ненужные и очищать весь список для создания новой подборки объектов.

<table><thead><tr><th width="213">Кнопка управления</th><th>Описание</th></tr></thead><tbody><tr><td><code>Add</code></td><td>Добавить новый объект в список.</td></tr><tr><td><code>Delete</code></td><td>Удалить объект из списка.</td></tr><tr><td><code>Clear</code></td><td>Очистить весь список.</td></tr><tr><td><code>Generate</code></td><td>Создать список объектов в текущей кисти из выделенных объектов сцены.</td></tr></tbody></table>

## Окно свойств

Окно свойств выделенного объекта \[-**Properties-**] предназначено для настройки параметров выбранного объекта из списка растительности. Эти параметры позволяют настроить активность объекта, его поведение при размещении в сцене.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2F1BvA4WH1FmAOkjX44SqW%2Feditor.png?alt=media&amp;token=77d1e377-a4c7-44a0-9402-4f5d0112c3ce" alt=""><figcaption></figcaption></figure>

### **Активность и основной объект**

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

<table><thead><tr><th width="212">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><code>Activate</code></td><td>Флажок определяет, будет ли выбранный объект активен для рисования</td></tr><tr><td><code>Entity</code></td><td>Относительный путь к файлу объекта, который будет использован для рисования</td></tr></tbody></table>

### **Рисование**

Параметры раздела Painting определяют плотность объектов, минимальное расстояние между ними, а также их масштаб. Эти параметры обеспечивают контроль над тем, как объекты будут размещены в сцене.

<table><thead><tr><th width="247">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><code>Density</code></td><td>Определяет плотность экземпляров объекта при рисовании</td></tr><tr><td><code>Radius</code></td><td>Минимальное расстояние между экземплярами объекта при рисовании</td></tr><tr><td><code>Apply Radius to All</code></td><td>Включение флажка позволяет применить настройки указанного радиуса ко всем объектам в списке <code>Foliage list</code></td></tr><tr><td><code>Scale</code></td><td>Определяет случайный масштаб объектов в заданном диапазоне.</td></tr></tbody></table>

### **Размещение**

Параметры раздела `Placement` контролируют размещение объектов в пространстве сцены, включая смещение, ориентацию по нормали поверхности, случайное вращение и наклон, а также допустимые углы и высоты для размещения.

<table><thead><tr><th width="255">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><code>Z Offset</code></td><td>Задает случайное смещение по оси Z для каждого экземпляра объекта</td></tr><tr><td><code>Align to Normal</code></td><td>Включает выравнивание экземпляра объекта по нормали поверхности</td></tr><tr><td><code>Align Max Angle</code></td><td>Задает максимальный угол отклонения экземпляра объекта от нормали</td></tr><tr><td><code>Random Yaw</code></td><td>Определяет случайное вращение экземпляра объекта вокруг вертикальной оси</td></tr><tr><td><code>Random Pitch Angle</code></td><td>Определяет случайный наклон экземпляра объекта по оси Х</td></tr><tr><td><code>Ground Slope Angle</code></td><td>Ограничивает размещение объектов поверхностями с определенным углом наклона</td></tr><tr><td><code>Height</code></td><td>Определяет диапазон высот, в котором объекты могут быть размещены</td></tr></tbody></table>

### **Вид**

Настройки View определяют визуальные параметры экземпляров объекта и служат для тонкой настройки внешнего вида объектов в сцене.

<table><thead><tr><th width="255">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><code>Opacity</code></td><td>Управляет уровнем прозрачности объектов.</td></tr><tr><td><code>Color</code></td><td>Устанавливает цвет объектов в сцене.</td></tr></tbody></table>