> 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-vysot.md).

# Редактор высот

Набор инструментов вкладки **Редактора высот** \[`Heights`] используется для изменения рельефа меша поверхности земли, что позволяет создавать холмы, горы, долины, овраги, низины.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FdxcINYOj0xLGybaS5vOa%2FLand-Heights%20Editor.jpg?alt=media&amp;token=59f6108f-4da7-40aa-b966-8bafd0f42072" alt=""><figcaption><p>Интерфейс окна вкладки Heights</p></figcaption></figure>

## Элементы интерфейса Редактора высот

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FP9E98UsZkn2ufONAltl6%2FHeight%20Editor_brush2.png?alt=media&amp;token=e56a70e7-3100-4cd7-b922-d0d0a70e1196" alt=""><figcaption><p>Окно инструментов <strong>Редактора высот</strong></p></figcaption></figure>

* Кисть `Heigths` для создания и редактирования рельефа поверхности земли.
* \[2] Инструменты настройки кисти `Heights`.
* \[3] Дополнительные функции Редактора высот.
* Инструменты для переноса рельефа поверхности:
  * \[4] импорт рельефа;
  * \[5] экспорт рельефа;
  * \[6] план-декаль.
* \[7] Блок информации о пределах высот карты.

## **Принцип работы кисти Heights**

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FibTTdxJ9jH3mZhK36R5O%2FHeight%20Editor_1.png?alt=media&amp;token=5a0b9bff-519e-4a5e-8f32-9cf500580f66" alt=""><figcaption><p>Кисть Heights для редактирования рельефа поверхности земли</p></figcaption></figure>

* При зажатой `ЛКМ` кисть поднимает вертексы меша поверхности земли.
* При зажатой `ПКМ` вертексы опускаются.
* Движение мышью с зажатой клавишей Shift сглаживает перепады высот для вертексов меша поверхности земли, попадающих в область кисти.
* Удержание клавиши `Alt` фиксирует выравнивание вертексов по уровню точки, находящейся под кистью на момент зажатия `Alt`.
* Диаметр кисти регулируется клавишами Плюс `+` и Минус `-` на цифровой клавиатуре.

{% hint style="info" %}
Комбинация клавиш `Alt+W` используется для включения и переключения режимов отображения полигональной сетки меша поверхности земли.
{% endhint %}

## Настройки кисти Heights

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FEaI9aVZp5I4sm9HtWvXR%2FHeight%20Editor_2.png?alt=media&amp;token=5d77fd65-22a3-47f5-afe3-228338a2b439" alt="" width="563"><figcaption><p>Настройки кисти <code>Heights</code></p></figcaption></figure>

* **Слайдер Soft-Sharp** \[2.1]
  * Положение `Sharp` делает кисть жесткой, все вертексы изменяют высоту с одинаковой интенсивностью.
  * Положение `Soft` снижает интенсивность воздействия кисти, создавая плавные переходы от центра к краям.
* **Слайдер Slow-Fast** \[2.2] регулирует скорость изменения высот.
* **Фиксация высоты** \[2.3]
  * Включение опции `fixed height` фиксирует высоту на уровне, заданном в соответствующем поле.
  * Опция `fix relative` активирует дискретное изменение высоты, поднимая вертексы при каждом клике `ЛКМ` и опуская при клике `ПКМ` на значение, которое указано в поле `fixed height`.

## Дополнительные функции Редактора высот

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FDA43SYrAFb2PG5Snyzug%2FHeight%20Editor_3%20(1).png?alt=media&amp;token=07686031-4cc0-4af3-86ce-609a30d4e99f" alt="" width="563"><figcaption><p>Функции отладки и настройки рельефа ландшафта</p></figcaption></figure>

<table><thead><tr><th width="295">Инструмент</th><th>Назначение</th></tr></thead><tbody><tr><td>[3.1] <code>heightmap</code></td><td>Визуализация сетки с указанием параметра угла наклона рельефа для отладки.</td></tr><tr><td>[3.2] <code>Heightmap level</code></td><td>Отладка крутизны склонов для проверки проходимости территории.</td></tr><tr><td>[3.3] <code>Water altitude</code></td><td>Параметр уровня моря для выравнивания объектов по уровню воды.</td></tr><tr><td>[3.4] <code>Clip heightmap</code></td><td>Обрезка размеров сетки высот по границам видимой части меша поверхности земли.</td></tr><tr><td>[3.5] <code>Heightmap by mesh</code></td><td>Синхронизация сетки высот по видимому мешу поверхности земли.</td></tr></tbody></table>

## Инструменты переноса рельефа

Вкладка **Редактора высот** содержит инструменты позволяющие создать рельеф карты при помощи топографической карты или `Land decal`, а также переносить рельеф меша **поверхности земли** с одной карты на другую.

### Импорт рельефа

Инструмент `Import heightmap` позволяет создать рельеф на основе топографической карты.\
Поддерживается импорт рельефа из изображений, сохраненных в форматах `tga`, `ebm`, `bmp`, `dds`, `jpg`, `png`.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FhIXk7gyErX48JUqorG6G%2FHeight%20Editor_4.png?alt=media&amp;token=c77698e4-67f6-4c51-a972-3d6e681acb62" alt="" width="563"><figcaption><p>Инструменты импорта рельефа</p></figcaption></figure>

**Инструкция для импорта рельефа**

1. **Подготовить изображение карты высот**\
   Для карты высот используется изображение в градациях серого:

   * `черный цвет` обозначает наименьшую высоту;
   * `белый` — наибольшую;
   * `оттенки серого` соответствуют промежуточным высотам.

   Технические требования к изображению: `8-bit`, `grayscale`, размер изображения не более `8K`.\
   Соотношение сторон изображения должно совпадать с соотношением сторон карты (например, `1:1` для квадратных карт).\
   Сохранить изображение в папку `scene\texture`. Для удобства работы рекомендуется создать отдельную папку для изображений, предназначенных для импорта карты высот.
2. **Установить параметры импорта**
   * `Max height` \[4.1] — задает максимальную высоту рельефа в метрах. Это соответствует самой высокой точке поверхности земли, предусмотренной дизайном карты.\
     Для преобразования игровых единиц высоты в метры используется соотношение:\
     `1 метр = 20 единиц высоты`.
   * `Zero height` \[4.2] — задает `оттенок серого`, который соответствует `нулевому уровню` поверхности земли.\
     По умолчанию, `черный цвет` в изображении карты высот соответствует `нулевому уровню` высот **поверхности земли**.\
     Этот параметр необходимо настроить для карт с уровнями высот ниже `нулевого уровня`, например, русла озер или другие низменные области.

{% hint style="warning" %}
Нажатие кнопки `Get min/max data` \[4.3] устанавливает при импорте минимальное и максимальное значение высоты вертексов поверхности земли из текущей карты.
{% endhint %}

3. **Выполнить импорт карты высот**\
   Нажать кнопку `Import heightmap` \[4.4], затем выберите файл изображения для импорта карты высот из папки `scene\texture` (или из папки, в которую было сохранено изображение в пункте 1. )

### Экспорт рельефа

Инструмент `Export heightmap` позволяет создать топографическую карту на основе рельефа поверхности земли текущей карты.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FlWH6vnwiN33raYXE273P%2FHeight%20Editor_5.png?alt=media&amp;token=052b0ebc-29dd-485d-8327-e5971350e2e7" alt="" width="563"><figcaption><p>Инструменты экспорта рельефа</p></figcaption></figure>

**Инструкция для экспорта рельефа**

1. Установить размер изображения, заполнив значения параметров `Image width` и `Image height` \[5.1]
2. Нажать `Export heightmap` \[5.3], выбрать папку для сохранения файла и задать имя файла.

{% hint style="info" %}
Выставление флажка `Float DDS` \[5.2] дает команду движку сохранять карту высот в формате 32-битных чисел с плавающей запятой (float).\
Опция используется для повышения точности сохранения высот и плавности градиентов.
{% endhint %}

{% hint style="warning" %}
При отключении опции `Float dds` \[5.2] карта высот будет сохранена в менее точном формате (8- или 16-бит), что уменьшает размер файла, но может привести к потере деталей и артефактам на сложных рельефах.
{% endhint %}

### План-декаль ландшафта

Инструмент `Land decal`\[6] используется для наложения текстуры на всю карту, что упрощает создание карт на основе реальной местности.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FW4rd9N0GsEmzx7NNASkl%2FHeight%20Editor_6.png?alt=media&amp;token=5a18da13-b68f-452f-ae41-b430d0caea78" alt="" width="563"><figcaption><p>Элементы интерфейса инструмента Land decal</p></figcaption></figure>

#### Работа с Land decal

1. **Подготовка текстуры**
   * Подготовить изображение для декаля в одном из поддерживаемых форматов: `.jpg`, `.png`, `.tga`, `.dds`.
   * Рекомендуется установить размер изображения пропорционально размеру карты.\
     Например, для карты 650x650 метров лучше всего использовать изображение 650x650 пикселей (масштаб 1:100 м) или 1300x1300 пикселей (масштаб 1:50 м), либо в соответствии с план-схемой.
2. **Сохранение текстуры**
   * Сохранить изображение в директорию `scene/texture`. Для удобства можно создать отдельную папку для декалей.
3. **Добавление декаля на карту**
   * Открыть вкладку редактора высот.
   * В блоке `Land Decal` нажать кнопку `Create` для наложения декаля на карту.
   * Выбрать подготовленное ранее изображение из директории `scene/texture`.
4. **Настройка декаля**
   * Настроить прозрачность декаля с помощью ползунка `Transparency`, чтобы обеспечить удобство работы с картой.
5. **Удаление декаля**
   * Нажать кнопку `Remove` в блоке `Land Decal` для удаления декаля.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe-WxiEQF0qJOcNwda-I_-L2pzFeYN-X45GGwHZKmJVxdBXpUcln3RKaBuyYsR4_9oBtMhKeGdgQpqkxiD42OLR16mrKE5rs88ingbWRW4eoaEfgcZSL0WvJPk-UgxGqvEZhpzflTAg8zf3Bjqz2Hc2OLPb?key=_TqNsGBjHk_sRtGwndNdHg" alt=""><figcaption><p>Иллюстрация результата наложения план-декаля на поверхность карты</p></figcaption></figure>

## Вспомогательные карты высот

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

Для визуализации вспомогательных карт и их последовательного переключения используется комбинация клавиш `Alt+H`. Последнее нажатие отключает режим визуализации вспомогательных карт.

<table><thead><tr><th width="251">Название карты</th><th>Назначение</th></tr></thead><tbody><tr><td>Карта видимости<br><code>Visibility heightmap</code></td><td><p>Разноцветная сетка, которая огибает поверхность земли и объекты, расположенные на ней.<br><strong>Цвета сетки</strong> соответствуют высоте закрытия видимости относительно земли:</p><ul><li><strong>синий</strong> - до 0.25м</li><li><strong>сиреневый</strong> - 0.25 .. 1.25м,</li><li><strong>желтый</strong> - 1.25 .. 2м,</li><li><strong>зеленый</strong> - 2м .. 3м,</li><li><strong>красный</strong> - 3м и выше</li></ul></td></tr><tr><td>Карта высот<br><code>Land heightmap</code></td><td>Визуализация высоты ячеек полигональной сетки поверхности земли.<br>Цвет сетки меняется в зависимости от минимальной и максимальной высоты.<br>Используется в движке для рассчетов, связанных с соприкосновением и пересечениями с поверхностью земли.</td></tr><tr><td>Карта типов территорий<br><code>Terrain heightmap</code></td><td>Разноцветная сетка, повторяющая изгибы меша поверхности земли, с разметкой <a href="/gem-rts-v1-ru/redaktor/redaktor-kart/redaktor-landshafta/tipy-territorii.md">Типов Территорий</a>.<br>Цвет контуров сетки определяется параметром типа территории <code>РР color</code>.<br>Цвет заполнения ячеек определяется параметром спецэффектов <code>FX color</code></td></tr><tr><td>Карта поиска пути<br><code>Path planner</code></td><td><p>Визуализация Карты высот с отображением уровня угла наклона ячейки в горизонту.<br>Эта же карта отображается при установке флажка <code>heightmap</code> в интерфейсе вкладки Редактора высот <code>Heights</code>.<br>Цвета обозначают соответствие угла наклона выбранному уровню:</p><ul><li><strong>синий</strong> - выше или равно указанному уровню;</li><li><strong>серый -</strong> ниже указанного уровня.</li></ul><p>Используется, как инструмент проверки проходимости местности в зависимости от угла наклона поверхности к горизонту в расчетах <a href="/gem-rts-v1-ru/nastroiki-igrovykh-parametrov/dvizhenie-po-sklonam.md">Поиска Пути</a> юнитов</p></td></tr><tr><td>Карта разметки флагов<br><code>Flags</code></td><td>Разметка поверхности земли <a href="/gem-rts-v1-ru/redaktor/redaktor-kart/redaktor-landshafta/flagi.md">Флагами</a>, запрещающими игровые действия.</td></tr></tbody></table>