понедельник, 27 мая 2019 г.

Документация на русском языке Mesh to Terrain

 Описание


Компонент для преобразования 3D-моделей в Unity Terrain. Может работать как со всеми объектами на слое, так и только с выделенными объектами. Не требует ручного добавления компонентов физики (коллайдеры).

Как использовать


Добавьте 3D-модель, которую вы хотите преобразовать в Terrain. Количество моделей не ограничено, и они могут иметь любую вложенность.

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

Выберите пункт меню «Window/Infinity Code/Mesh to Terrain», чтобы открыть компонент.

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

Важно: если модель имеет коллайдер, отличный от «Mesh Collider», он может быть неправильно преобразован. Чтобы решить проблему, удалите компонент коллайдера из моделей.

Описание полей

 

Окно Mesh to Terrain содержит три раздела:
  • Meshes - список мешей, которые будут преобразованы в местности, и общие настройки преобразования.
  • Terrains  - Настройки Terrains.
  • Textures  - Настройки текстур.


Meshes


В «Mesh select type» раздела  Meshes выберите, как вы хотите определить модель для преобразования:
  • GameObjects - объекты, которые будут добавлены вручную. Для всех добавленных объектов рассматриваются подобъекты. Чтобы избежать ошибок, необходимо удалить все ненужные подобъекты из объектов, не относящихся к Terrains.
  • Layers - как модели для преобразования всех моделей, используемых в слое. Во избежание ошибок со слоя необходимо убрать все ненужные объекты, которые не относятся к местности.
В поле «Direction» укажите направление трассировки лучей:

  • Normal  - лучи идут сверху вниз.
  • Reversed - лучи идут снизу вверх. Должен использоваться, если полигональная модель обращена вниз.

В «Y Range» выберите желаемый диапазон высот:

  • Minimal Range - диапазон значений будет определяться автоматически на основе границ сетки Y.
  • Long Mesh Side - диапазон значений будет определяться автоматически на основе границ сетки по максимальному размеру X и Z.
  • Fixed Value - позволяет указать диапазон Y вручную. Чем выше значение, тем ниже точность.


 Terrains


В «Type» раздела Terrains выберите:

  • Exist Terrains - Если вы хотите преобразовать уже существующие ландшафты. Для этого разместите Terrains под моделями и добавьте Terrains в список. 
  • New Terrains - Terrains будут созданы и помещены под модель автоматически. В соответствующих полях количество мест, которые будут созданы.
Если выбран «Type - New Terrains», то существуют дополнительные настройки:

  • Count - количество Terrains, которые вы хотите получить.
  • Adjust size of meshes - размер мешей будет скорректирован, чтобы обойти проблему рейкастинга для очень маленьких и очень больших мешей. После генерации Mesh to Terrain восстановит исходную иерархию и размер мешей.
Важно: если меши являются частью префабов, то, после использования этого параметра, префаб будет утерян.
  • Bounds  - тип границы модели:
    • Auto Detect - границы модели определяются автоматически.
    • From GameObject - границы модели, установленные другим GameObject. Этот GameObject должен быть Cube без вращения и включать всю область, которую вы хотите конвертировать.
    • Select Bounds - вы выбираете границы вручную (как в коллайдере). Нажмите «Show Selected», чтобы начать выделение границ.
  • New terrains settings -  Новые настройки местности.

Если вы хотите использовать сглаживание, выберите «Use smoothing of height maps» и установите коэффициент сглаживания.


Поле «Holes» определяет поведение рельефа меша для областей моделей, где высота неизвестна (отверстия и края модели, если модель не прямоугольная):

  • Minimum Value - Минимальное значение - будет использоваться минимальная высота.
  • Neighbor Average - высота будет рассчитываться на основе соседних известных значений.

Текстуры


Mesh to Terrain может дополнительно генерировать одну текстуру для каждого Terrains.

Mesh to Terrain имеет два режима генерации текстур:

Camera - текстуры будут создаваться с использованием динамической камеры с ортогональной проекцией. Обязательно Отрегулируйте размер ячеек - ON.
    Важно: при создании текстур используется освещение, которое повлияет на результат. Подготовьте освещение в первую очередь.
  • Raycasting - текстуры будут создаваться путем Raycasting основных текстур мешей.
    Важно: этот режим генерации текстур использует только основную текстуру первого материала.


Конвертировать из контекстного меню


В «Hierarchy» щелкните правой кнопкой мыши GameObject, который вы хотите преобразовать в Terrain. Открывает «Mesh to Terrain» с выбранным GameObject.


Отверстия


Unity Terrains не поддерживают отверстия, но вы можете обходить это.

Используйте «Holes», чтобы определить поведение меша Terrains для областей моделей, где высота неизвестна (отверстия и край модели, если модель не прямоугольная).

Если вы хотите сделать отверстия, вы можете использовать сторонний ассет (Terrain Hole System или подобный)

Работа с Relief Terrain Pack

Relief Terrain Pack не входит в пакет Mesh to Terrain и, по умолчанию, интеграция отключена.

Импортируйте Relief Terrain Pack в свой проект. Откройте Mesh to Terrain. Third-party/Enable Relief Terrain Pack.

Никаких настроек Relief Terrain Pack не требуется. Если у вас есть какие-либо вопросы о Relief Terrain Pack, вы можете найти ответы в документации к Relief Terrain Pack.

Если вы хотите удалить Relief Terrain Pack из проекта, вы должны сначала отключить его в Mesh to Terrain (Third-party/Disable Relief Terrain Pack).

Если вы забудете отключить Relief Terrain Pack и удалить его, то в консоли вы увидите ошибки. Чтобы вручную удалить поддержку Relief Terrain Pack, откройте PlayerSettings (Edit / Project Settings / Player) и удалите соответствующую запись из «Scripting Define Symbols».


Обновление версий

В Unity Asset Store мы поставляем только стабильные версии. Срок продления составляет несколько месяцев.

Mesh to Terrain имеет встроенную систему обновлений, с помощью которой вы можете получить ранний доступ ко всем версиям и обновлениям.

Нажмите «Window / Infinity Code / Mesh to Terrain / Check Updates», чтобы открыть окно проверки обновлений. Введите свой номер счета, выберите канал обновлений и нажмите «Check New Versions».

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

Если у вас возникли проблемы с установкой обновления, то:
  • Откройте пустую сцену.
  • Удалите папку «Infinity Code / Mesh to Terrain».
  • Импортируйте новую версию ассета в проект.

Поиск проблемы

После запуска вы получаете ошибку границы или ничего не происходит.

Для этого есть две причины:
  • Модели в сцене имеют размер, которого недостаточно для правильной работы физики. Вам нужно увеличить модель в 100+ раз и снова запустить компонент. Проблема в том, что по умолчанию масштабный коэффициент импортируемых моделей «0,01».
  • Вы выбираете модели не в сцене. Добавьте модель в сцену и конвертируйте их.
Terrains не соответствуют моделям оси Y.
  • Масштабируйте модель в несколько раз.

Новые Terrains имеют недостаточное разрешение / точность.
  • Увеличьте разрешение карты высот.
  • Увеличьте количество новых Terrains.
Вы не видите траву или деревья.
  • Нажмите на место, где вы рисуете траву или деревья.
  • Увеличьте значение «Tree Distance» в настройках Terrain.
Появляется ошибка «Selected meshes not in the scene», а модель на сцене.

Пожалуйста, убедитесь, что вы выбрали модель на вкладке «Scene».


Служба поддержки

Мы предоставляем поддержку по электронной почте (support@infinity-code.com) на английском и русском языках или через форум (http://forum.infinity-code.com) на английском языке.

Если у вас что-то не работает, вы нашли ошибку или у вас есть предложение, пожалуйста, свяжитесь с нами.

Пожалуйста, укажите вашу версию Unity, ОС и текущую версию Mesh to Terrain.

Мы стремимся ответить на все электронные письма в службу поддержки в течение 24 часов.


Заключительные слова

Мы искренне надеемся, что вам понравится использовать Mesh to Terrain.

Если у вас есть какие-либо вопросы или проблемы, пожалуйста, свяжитесь с нами.

Мы постараемся помочь вам как можно быстрее.



Пожалуйста, не забудьте оставить свой отзыв в Unity Asset Store.

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

Для других пользователей также очень важно правильно понять этот ассет.