Введение

Когда вы приступаете к разработке приложения в UNIGINE, вы создаете проект. Проект содержит в себе код, контент и метаданные разрабатываемого приложения.

Проект может состоять из одной или нескольких многокомпонентных 3D сцен, которые называются мирами (worlds).

Управление проектами осуществляется через UNIGINE SDK браузер.

Виртуальный мир (world) в UNIGINE представляет собой 3D-сцену, которая включает в себя множество различных нод (nodes), таких как статическая геометрия, источники освещения, камеры и т. д., организованных в графы сцены, которые установлены в определенном положении, а также глобальные настройки (рендеринг, физика и пр.), которые применяются ко всей сцене.

Граф сцены в UNIGINE — это иерархическая древовидная структура нод.

Каждый мир представлен XML-файлом с расширением .world.

При создании нового проекта через SDK браузер создается и новый *.world файл, имя которого идентично названию проекта.

Для редактирования существующих миров и создания новых используется редактор UnigineEditor. Количество создаваемых миров не ограничено.

В UNIGINE все объекты, добавляемые в сцену, называются нодами (nodes). Ноды могут быть различных типов в зависимости от своего визуального представления и поведения.

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

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

У каждой ноды есть своя матрица трансформации, которая определяет положение, вращение и масштаб ноды в виртуальном мире.

Есть ноды, которые имеют визуальное представление: объекты, эффекты и декали. У них есть поверхности, которые определяют их геометрию (полигональную сетку). Остальные типы нод (источники освещения, камеры и т. д.) невидимы.

Параметры нод, как правило, хранятся в файле с расширением .world, но могут храниться и в отдельных XML-файлах с расширением .node. На эти файлы можно ссылаться из файла .world через ссылочные ноды (Node References) — специальные ноды, которые используются для подгрузки нод).

Меш (mesh) — это набор полигонов, который определяет геометрию объекта. Ему присущи следующие особенности:

• у каждого меша есть одна или несколько поверхностей;
• максимальное число полигонов, из которых может состоять поверхность, равняется 2 147 483 647 (для ObjectMeshStatic и ObjectMeshSkinned) или 65 535 (для ObjectMeshDynamic);
• 2 UV-канала для текстурирования;
• поддержка цветов вершин.

Анимацию в UNIGINE можно реализовать с использованием скелетной анимации (skinned mesh), морфинговых объектов (morph targets) — ключевых кадров или динамических мешей (dynamic mesh) — через код.

В среде выполнения меши хранятся в собственных форматах UNIGINE с расширениями .mesh (статический меш + дополнительные данные об анимации) и .anim (внешние данные об анимации).

Импорт модели FBX в движок подразумевает автоматическую конвертацию в формат .mesh.

Поверхность (surface) — это подмножество геометрии (т. е. меша) объекта, не перекрывающее другие подмножества. Для каждой поверхности можно назначить собственный материал или свойство. Кроме того, каждую из поверхностей независимо от других можно включить или выключить.

Поверхности внутри меша можно организовать в иерархию и использовать для переключения между уровнями детализации (LOD).

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

В терминах UNIGINE материал (material) — это правило, которое определяет, как будет выглядеть поверхность: ее взаимодействие с источниками освещения, параметры отражения и т. д. В основе этого правила лежат:

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

В UNIGINE есть готовый набор встроенных базовых материалов. При работе с материалами рекомендуется унаследовать пользовательский материал от базового и откорректировать настройки для получения желаемого результата. Вы можете сами создать шейдеры при помощи языка UUSL (Unified UNIGINE Shader Language) или HLSL/GLSL, но тогда вам придется самостоятельно переносить их при каждом релизе SDK.

Помимо обычных материалов, которые применяются к поверхностям, существуют так называемые материалы для постобработки, которые применяются поверх финальной картинки (например, для создания эффекта ночного видения или тепловизора). Вы можете создавать собственные пост-эффекты при помощи нестандартных пост-материалов и шейдеров.

Material Hierarchy

Иерархия материалов#

Свойство (property) — это “материал”, применяемый для логики приложений. При помощи свойства определяется поведение объекта и его взаимодействие с другими объектами и самим виртуальным миром. У свойств могут быть различные типы параметров — от обычного целого числа для подсчета заработанных персонажем очков до ноды, материала или файла (для текстур, мешей, звуков и т. д.), или свойства, тем самым упрощая доступ к различным ресурсам.

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

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

При помощи редактора UnigineEditor можно собрать виртуальный мир — импортировать и размещать в пространстве ноды, добавлять им материалы и свойства, выставлять освещение, а также корректировать глобальные настройки (такие как физику и рендеринг). Наш редактор практикует подход "Что видишь, то и получаешь", то есть вы сразу же видите финальный вариант сцены (как в среде выполнения).

Об импорте 3D моделей в UNIGINE мы рассказываем в этом обучающем видеоролике:

Освещение в мирах создается путем размещения источников освещения. У этих нод есть параметры, с помощью которых можно настроить различные характеристики света, такие как яркость, цвет и т. д. Для настройки источников освещения можно использовать и физические параметры, такие как цветовая температура и освещённость.

Различные типы источников излучают свет различными способами. Например, лампочка излучает свет во всех направлениях. В UNIGINE она представлена источником ненаправленного освещения (omni light). Фонарь или фары автомобиля излучают свет в виде конуса в определенном направлении, представляя собой источник направленного освещения (projected light). Лучи света от солнца кажутся параллельными, поскольку их источник находится на очень большом расстоянии. Для имитации такого типа освещения в UNIGINE применяется источник глобального освещения (world light).

Подробнее об освещении в UNIGINE смотрите в обучающем видеоролике по освещению.

UNIGINE сочетает полностью отложенный рендеринг с применением методов прямого рендеринга:

• вся непрозрачная геометрия отображается на отложенном этапе (deferred pass);
• прозрачная геометрия отрисовывается на этапе прямого рендеринга (forward pass).

Более детальная информация о применяемых методах рендеринга приводится в статье Rendering Sequence.

Все настройки рендеринга (глобальное освещение, тени, сглаживание контура, пост-эффекты и т. д.) можно регулировать через настройки рендеринга в UnigineEditor и сохранять в файле с расширением *.render для последующего использования. Каждый проект содержит настройки для предустановок низкого, среднего, высокого и ультравысокого качества, а также оптимизированные настройки для оптимальной работы в VR. Для того чтобы применить необходимые настройки, выберите их двойным щелчком в браузере ассетов (Asset Browser).

Чтобы объект мог участвовать во взаимодействиях с другими объектами или внешними физическими силами, нужно задать ему некоторые физические свойства. А для этого у объекта должно быть тело (body). Существует несколько видов тел: твердое (rigid body), тряпичная кукла (ragdoll body), разрушаемое (fracture body), шнур (rope body), ткань (cloth body), вода (water body) и траектория (path body).

Виртуальная физика тела, почти так же, как и в реальном мире, оперирует понятиями скорости, силы, массы, плотности и т. д.

В отличие от тела, которое имитирует различные типы физического поведения, форма (shape) представляет собой некоторый объем (сфера, капсула, цилиндр, куб, выпуклый многоугольник), который твердое тело занимает в пространстве. У объекта, для которого имитируется физика, обычно есть одно тело и одна или несколько форм, которые отвечают за коллизию (столкновение) объектов друг с другом.

Collision Detection

Определение коллизии#

Соединения (joint) используются для соединения нескольких объектов с учетом баланса масс и ограничения степеней свободы их движения относительно друг друга. В UNIGINE представлены различные виды соединений: жесткое (fixed joint), шарнирное (hinge joint), шаровое (ball joint), призматическое (prismatic joint), цилиндрическое (cylindrical joint), колесное (wheel joint) и подвеска (suspension joint).

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

Для реализации логики проекта в UNIGINE могут использоваться следующие языки программирования:

• C++ обеспечивает максимальную производительность и эффективную интеграцию с существующей базой исходного кода.
• C# — разумное соотношение скорости и простоты использования.
• UnigineScript — скриптовый язык с мгновенной компиляцией и множеством полезных функций.

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

Дополнительная информация приводится в следующих статьях с примерами использования кода:

• UnigineScript API, C++ API and C# API usage examples
• Examples of UnigineScript extension using C++ API
• Examples of UnigineScript extension using C# API

Mixing Languages

Использование нескольких языков в одном проекте#

У приложений, разработанных на UNIGINE, есть собственный жизненный цикл, который состоит из определенных этапов. Какие-то из этих этапов выполняются однократно, остальные же отрабатываются каждый кадр. Схематически эти этапы можно представить следующим образом:

В UNIGINE есть три основных логических компонента. В каждом из них есть набор функций (которые называются init(), update(), render() и т. д.), содержащих действия, которые выполняются на соответствующих этапах рабочего цикла движка. Эти компоненты называются системная логика, логика мира и логика редактора.

• Системная логика (system logic) включает в себя код, который выполняется в течение всего жизненного цикла приложения (его объем существует даже при переключении между мирами).

  • Для приложений, написанных на UnigineScript, системная логика пишется в файле системного скрипта (unigine.usc).
  • Для приложений на C++ создается файл AppSystemLogic.cpp, а для приложений на C# — AppSystemLogic.cs. Этот файл хранится в папке source/ вашего проекта. В файле уже реализованы методы для добавления кода.

• Логика мира (world logic) — это логика виртуального мира. Эта логика используется, только когда загружен данный мир.

  • Для приложений, написанных на UnigineScript, логика мира пишется в файле скрипта мира (файл *.usc с названием как у проекта); загружается и выгружается вместе с соответствующим миром.
  • Для приложений на C++ создается файл AppWorldLogic.cpp, а для приложений на C# — AppWorldLogic.cs. Этот файл хранится в папке source/ вашего проекта и остается загруженным в течение всего рабочего цикла движка. В файле уже реализованы методы для добавления кода.

• Логика редактора (editor logic). Этот компонент следует использовать в случае, если вам нужен собственный редактор. В нем реализовано больше методов, дающих вам четкое представление о текущих событиях Engine (создана нода, удалено свойство, изменен материал и т.д.).

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

Component System

Компонентная система#

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

Возможен также поиск пересечения между ограничивающими объёмами нод.

В UNIGINE представлен обширный набор примеров и демонстрационных проектов, которые иллюстрируют основные принципы работы с движком (операции со встроенными нодами, настройки рендеринга и GUI и т. д.). Представлены примеры для каждого из трех языков программирования. Для всех примеров предоставлен исходный код. Посмотреть примеры можно в SDK браузере -> вкладка Samples.

Помимо этого в SDK входит набор демонстрационных сцен с контентом, иллюстрирующих возможности различных настроек встроенных объектов UNIGINE, использование уровней детализации и материалов, регулировку настроек рендеринга и параметров растительности. Эти примеры доступны в UNIGINE SDK браузере в качестве демо-проекта: откройте Samples -> Demos и установите демо-проект Samples.

Чем проще геометрия 3D-объектов, тем меньше нагрузка на рендер. Поэтому при увеличении расстояния между камерой и объектами имеет смысл плавно переключаться между уровнями их детализации (LOD-ами).

Как правило, LOD-ы используются для переключения между следующими парами:

• высокополигональная поверхность меша — низкополигональная поверхность меша;
• поверхность со сложными для рендеринга материалами — поверхность с упрощенными оптимизированными материалами;
• несколько высокополигональных поверхностей меша — одна низкополигональная упрощенная поверхность меша;
• с одного типа ноды на другой, например, высокополигональный меш — биллборд (объект из двух полигонов, который всегда повернут лицом к камере).

Переключение между LOD-ами может быть связано с расстоянием не только от камеры, но и от какого-либо объекта.

В UNIGINE предусмотрено два механизма смены LOD-ов:

• Выключение одного LOD-а и включение другого на указанном расстоянии, которое задается двумя значениями: конец видимости первого LOD-а (Max Visibility) и начало видимости второго LOD-а (Min Visibility).

  

• Плавный переход (fade) между LOD-ами в указанном интервале, который задается двумя значениями: расстояние плавного появления первого LOD-а (Min Fade) и расстояние плавного исчезновения первого LOD-а / расстояние плавного появления второго LOD-а (Max Fade).

  

Более подробно об этом рассказывается в статье Setting up object LODs.

Механизм битовых масок (bit mask) определяет, будут ли две сущности воздействовать друг на друга. Он может использоваться для того, чтобы:

• отображать определенные объекты в окне просмотра (viewport) и не отображать другие;
• применять коллизию для одних тел и не учитывать ее для других;
• отображать тени для одних объектов и не отображать для других;
• обеспечивать физическое воздействие на одни объекты и игнорировать другие.

Алгоритм битовых масок сравнивает 32-битные маски каждой пары нод, используя бинарный оператор и. Если маски совпадают, то один объект воздействует на другой; если не совпадают, то объекты взаимодействовать не будут.

Маски считаются совпадающими, если хотя бы один бит совпадает. Например, в иллюстрации ниже маски совпадают, поскольку у них них есть четыре совпадающих бита: