# Редактор Foliage

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

<figure><img src="/files/iL3yNzwz4UZIUw7HqWZk" alt=""><figcaption><p>Редактор Foliage</p></figcaption></figure>

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

* [Главное меню](#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="/files/Sjz0yV9mTfv6GT1jhand" 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>


---

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