This page has been translated automatically.
Видеоуроки
Interface
Essentials
Advanced
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Professional (SIM)
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Физика
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Настройки и предпочтения
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Landscape Tool
Sandworm
Использование инструментов редактора для конкретных задач
Расширение функционала редактора
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World Nodes
Звуковые объекты
Объекты поиска пути
Players
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Плагины
Форматы файлов
Materials and Shaders
Rebuilding the Engine Tools
GUI
Двойная точность координат
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Визуальный редактор материалов
Сэмплы материалов
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Внимание! Эта версия документация УСТАРЕЛА, поскольку относится к более ранней версии SDK! Пожалуйста, переключитесь на самую актуальную документацию для последней версии SDK.
Внимание! Эта версия документации описывает устаревшую версию SDK, которая больше не поддерживается! Пожалуйста, обновитесь до последней версии SDK.

Работа с проектами

Проект - это независимый объект, который содержит все данные о содержимом вашего приложения, организованные в наборе каталогов. Файл .project, содержащий метаданные, связан с проектом.

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

Release and Development BuildsСборки для выпуска и разработки#

Вы можете выбрать сборку UNIGINE Engine Development или Release:

  • Сборка Development включает дополнительные функции, которые могут быть полезны при разработке проекта (Microprofile и т.д.)
  • Сборка Release позволяет проверить конечную производительность приложения.

Creating New ProjectСоздание нового проекта#

Перед тем, как начать создавать новые проекты, у вас должен быть установлен SDK . Когда у вас будет необходимая версия SDK, вы можете создать новый проект следующим образом:

  1. Откройте вкладку Projects в браузере SDK.

  2. Щелкните Create New. Откроется окно создания нового проекта.
  3. Определите имя проекта, выберите путь для хранения файлов проекта, укажите SDK и UNIGINE Engine build , которые будут использоваться.

    Проект будет создан в папке <project path>/<unigine_project>.

  4. Укажите необходимое приложение и общие настройки .
  5. Укажите надстройки , которые нужно добавить (необязательно).
  6. Щелкните Create New Project. Проект появится в списке проектов.

Примечание
Вы можете изменить настройки проекта в любое время, нажав Other Actions -> Configure Project.

Application SettingsНастройки приложения#

Проект может быть создан со следующими настройками приложения:

Template Шаблон, который используется в качестве основы для проекта:
  • Empty - для проекта не используется шаблон.
  • VR - шаблон используется для облегчения создания пользовательского приложения для VR .
  • IG - шаблон используется для облегчения создания пользовательского приложения Image Generator .
API+IDE Programming language to be used for project creation. The following APIs are available:
  • UnigineScript only - для реализации проекта будет использован UnigineScript.
  • C++ - для реализации проекта будет использоваться C ++ API. Для проекта, использующего шаблон, следует использовать один из следующих вариантов в зависимости от ОС:
    • В Windows:
      • C++ (Visual Studio 2015)
      • C++ (Qt-based) - для сборки проекта требуется Qt Creator, QMake или CMake.
        Примечание
        Плагины приложения * ( AppProjection , AppSurround , AppWall , AppPanorama и другие) не могут использоваться в приложениях Qt-based.
      • C++ (CMake)
    • В Linux:
      • C++ GNU Make
  • C# (.NET 5) - C # API и Component System будут использоваться для реализации проекта. .NET 5 требуется для сборки проекта.
Precision Используемая точность координат:

Featuresобщие настройки#

Проект может быть создан со следующими общими настройками:

GUI-based settings configurator Создайте проект с помощью launcher .

Щелкните Plugins, чтобы указать следующее:

Oculus support (AppOculus plugin) Создайте проект с поддержкой виртуального дисплея Oculus Rift .
HTC Vive support (AppVive plugin) Создайте проект с поддержкой HTC Vive output .
Dual output stereo 3D (AppSeparate plugin) Выведите 2 отдельных изображения для каждого глаза.
Примечание
AppSeparate поддерживает только DirectX 11 .

3-monitor output (AppSurround plugin) Визуализируйте приложение на 3 мониторах одновременно .
Monitor wall (AppWall plugin) Выполните рендеринг приложения на настраиваемое количество мониторов .

Multi-projector setups (AppProjection plugin) Создайте проект с помощью плагина AppProjection. Копируются все необходимые файлы и генерируется лаунчер с соответствующими настройками.
EasyBlend support (AppEasyBlend plugin) Создайте проект с помощью плагина AppEasyBlend.

Syncker plugin Создайте проект с плагином Syncker для синхронизации многоканального рендеринга.
SSLSocket plugin Создайте проект с помощью подключаемого модуля SSLSocket .
Steam plugin Создайте проект с плагином для интеграции со Steam.
VRPN Client plugin Создайте проект с помощью плагина VRPN Client.
ARTTracker plugin Создайте проект с помощью плагина ARTTracker .

Kinect2 Plugin Создайте проект с помощью плагина Kinect2 .
GPU Monitor plugin Включите мониторинг частоты и температуры графического процессора для вашего проекта.
Leap Motion plugin Отслеживание рук и пальцев с помощью Leap Motion
Interface plugin Создайте проект с помощью плагина Interface.

Add-OnsДополнения#

Проект может быть создан, включая любые надстройки, доступные во вкладке Add-Ons. Все необходимые дополнения могут быть добавлены как при создании проекта, так и после него.

Specifying Add-Ons on Project's CreationУказание надстроек при создании проекта#

Чтобы создать проект с надстройкой:

  1. Загрузите необходимое дополнение во вкладке Add-Ons, нажав Install.

    Примечание
    Впоследствии в проект можно было добавить любое количество надстроек.
  2. В проекте creation укажите надстройки, которые нужно включить, нажав кнопку Add-ons (0).

  3. Отбросьте необходимые дополнения из поля Available в In Use. Вы можете добавить в проект любое количество надстроек. После сброса всех надстроек нажмите Ok.

    Примечание
    Если вы не скачали надстройку, нажмите Manage installed add-ons. Вы будете перенаправлены на страницу с доступными надстройками.
  4. Щелкните Create New Project. Чтобы включить добавленные надстройки в проект, вы должны следовать инструкциям для каждого надстройки .

Specifying Add-Ons for Existing ProjectУказание надстроек для существующего проекта#

Чтобы расширить существующий проект надстройками:

  1. Загрузите необходимое дополнение во вкладке Add-Ons, нажав Install.

    Примечание
    Впоследствии в проект можно было добавить любое количество надстроек.
  2. Щелкните Other Actions -> Configure Project.
  3. Нажмите кнопку Add-ons (0) и перетащите нужные надстройки из поля Available в In Use.

    Примечание
    Если вы не скачали надстройку, нажмите Manage installed add-ons. Вы будете перенаправлены на страницу с доступными надстройками.
  4. Щелкните Ok, а затем щелкните Update Configuration.

Adding Existing ProjectДобавление существующего проекта#

Чтобы добавить существующий проект в браузер:

  1. Щелкните Add Existing на вкладке Projects.
  2. В открывшемся диалоговом окне файла укажите путь к папке проекта и нажмите Apply. Проект появится в списке проектов.
Примечание
Если добавленный проект был создан в SDK предыдущей версии, он будет отмечен меткой Upgrade available.

Upgrading Existing ProjectОбновление существующего проекта#

Проекты, требующие обновления, отмечены меткой Upgrade available:

Чтобы обновить свой проект до последней установленной версии UNIGINE SDK:

  1. Щелкните этот ярлык или Other Actions -> Configure Project. Откроется следующая форма:
  2. Выберите самую последнюю установленную версию SDK и нажмите Update Configuration.
  3. Укажите путь к папке резервного копирования, в которую будет скопирован исходный проект. Оставьте Migrate Content отмеченным и нажмите Upgrade Project.

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

Примечание
Исходный код следует обновить вручную с помощью Руководства по миграции .

Running a ProjectЗапуск проекта с настройками по умолчанию#

Есть несколько вариантов запуска проекта с настройками по умолчанию:

  • Запустите проект без загруженного редактора, нажав Run.
  • Запустите проект с загруженным редактором, нажав Open Editor.
Примечание
Нажатие Open Editor запустит только редактор, вам придется загрузить мир вручную: через console , через File -> Open World в строке меню UnigineEditor или дважды щелкнув файл *.world в Asset Browser .

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

  • launch_debug - лаунчер отладочной версии проекта.
  • launch_editor - лаунчер проекта с загруженным редактором.
  • launch_release - лаунчер релизной версии проекта.
  • launcher - файл запуска для программы запуска, который предоставляет графический интерфейс для настройки параметров приложения и запуска приложения. Этот модуль запуска можно настроить и использовать в выпускной версии вашего проекта. Чтобы создать проект с помощью средства запуска, установите флажок конфигуратор параметров на основе графического интерфейса в окне создания проекта.

Running Project with Custom SettingsЗапуск проекта с пользовательскими настройками#

Также есть несколько вариантов запуска проекта с пользовательскими настройками:

  • Запустите проект без загруженного редактора, щелкнув многоточие под кнопкой Run:

    В открывшейся форме Customize Run Options задайте необходимые значения и нажмите Run.

  • Запустите проект с загруженным редактором, щелкнув многоточие под кнопкой Open Editor:

    В открывшейся форме Customize UnigineEditor Options задайте необходимые значения и нажмите Edit.

Примечание
Нажатие Open Editor запустит только редактор, вам придется загрузить мир вручную через console или через File -> Open World в главном меню UnigineEditor .

Настроить параметры запуска#

С помощью этой формы можно запустить проект без загруженного редактора с пользовательскими настройками.

В зависимости от значения параметра Application доступны разные наборы параметров:

  • Default - будет запущено основное приложение по умолчанию (<project_name>_x*.exe):

    Главное приложение по умолчанию следует использовать, если для реализации проекта используется только UnigineScript . В этом случае можно настроить следующие параметры:

    Debug Указывает, следует ли запускать отладочную или выпускную версию приложения.
    Microprofile Enabled Запустите приложение с включенным инструментом Microprofile .
    Arguments Параметры командной строки запуска .
    Remember Указывает, следует ли запоминать указанные пользовательские настройки для будущего запуска или нет.
  • Custom - будет запущено собственное основное приложение:

    Этот вариант следует выбрать, если для реализации проекта используется C++ or C# API(помимо UnigineScript). В этом случае можно настроить следующие параметры:

    Binary Имя настраиваемого основного приложения. Здесь необходимо указать имя скомпилированного двоичного исполняемого файла, расположенного в папке bin проекта. Если исполняемый двоичный файл находится за пределами этой папки, необходимо указать путь к нему относительно папки bin.
    Arguments Параметры командной строки запуска .
    Remember Указывает, следует ли запоминать указанные пользовательские настройки для будущего запуска или нет.

Customizing UNIGINE Editor OptionsНастроить параметры UnigineEditor#

Additional arguments Параметры командной строки запуска .
Debug Версия редактора (отладочная или выпускная), которая будет использоваться для редактирования проекта.
Remember Указывает, следует ли запоминать указанные пользовательские настройки для будущего запуска или нет.

Editing ProjectРедактирование проекта#

Чтобы открыть проект на редактирование:

  • В Windows щелкните Open Code IDE:

    Проект будет открыт для редактирования в связанном инструменте. Чтобы изменить инструмент, щелкните многоточие под Open Code IDE. По умолчанию откроется следующая форма:

    В раскрывающемся списке выберите Custom и укажите путь к настраиваемому инструменту (например, IDE или редактору) с необходимыми аргументами:

  • В Linux щелкните Open folder и затем отредактируйте код в соответствующем инструменте:

Смотрите также#

Other ActionsДругие действия#

При нажатии на кнопку Other Actions открывается следующая форма:

Configure Project Изменить настройки проекта.
Open Folder Откройте папку проекта.
Delete Удалите проект.

Updating Project ConfigurationОбновление конфигурации проекта#

При нажатии Other Actions -> Configure Project открывается следующая форма:

С помощью этой формы вы можете изменить настройки существующего проекта: сборка UNIGINE Engine , используемая для проекта, версия релизного приложения, точность координат и общие настройки . Эту опцию также следует использовать, когда вам нужно обновить существующий проект до последней версии SDK.

Кроме того, вы можете восстановить файлы проекта, которые были повреждены, пропущены или по ошибке изменены. Для этого следует оставить настройки в форме без изменений и нажать кнопку Update Configuration. В этом случае будут восстановлены следующие файлы проекта (они будут скопированы из SDK):

  • Бинарные файлы
  • core.ung, editor.ung and scripts.ung
  • Файлы запуска (Launchers)
Примечание
Если некоторые из файлов, перечисленных выше, изменены, к именам таких файлов добавляется постфикс .modified. При этом также будут скопированы файлы из SDK.
Последнее обновление: 10.03.2022
Build: ()