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

Проект - это независимый объект, который содержит все данные о содержимом вашего приложения, организованные в наборе каталогов. Файл .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.

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

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

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	Используемая точность координат: Float - одинарная точность Double - двойная точность

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

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

Command-line Runtimes Generator	Включает генератор времени выполнения через командную строку для проекта.
Command-line Build Tool	Включает инструмент сборки через командную строку для проекта.
Sandworm Distributed & Headless Mode	Позволяет создать консольное приложение, необходимое на компьютерах Worker для распределенных вычислений и генерации рельефа с помощью инструмента Sandworm для проекта.
Editor Plugin Template	Позволяет создать плагин редактора на основе доступных шаблонов для проекта. Примечание После выбора шаблона плагина и создания (или изменения конфигурации) проекта вы больше не сможете изменить шаблон.

Кнопка Plugins (0) открывает список доступных плагинов:

STEREO 3D
Oculus support (AppOculus plugin)	Создайте проект с поддержкой виртуального дисплея Oculus Rift .
Dual output stereo 3D (AppSeparate plugin)	Выведите 2 отдельных изображения для каждого глаза. Примечание AppSeparate поддерживает только DirectX 11 .
Varjo support (AppVarjo plugin)	Создайте проект с поддержкой Varjo output.
HTC Vive support (AppVive plugin)	Создайте проект с поддержкой HTC Vive output .
MULTI-MONITOR
3-monitor output (AppSurround plugin)	Визуализируйте приложение на 3 мониторах одновременно .
Monitor wall (AppWall plugin)	Выполните рендеринг приложения на настраиваемое количество мониторов .
PROJECTIONS
Multi-projector setups (AppProjection plugin)	Создайте проект с помощью плагина AppProjection. Копируются все необходимые файлы и генерируется лаунчер с соответствующими настройками.
EasyBlend support (AppEasyBlend plugin)	Создайте проект с помощью плагина AppEasyBlend.
NETWORK
ARTTracker plugin	Создайте проект с помощью плагина ARTTracker .
SSLSocket plugin	Создайте проект с помощью подключаемого модуля SSLSocket .
Steam plugin	Создайте проект с плагином для интеграции со Steam.
Syncker plugin	Создайте проект с плагином Syncker для синхронизации многоканального рендеринга.
VRPN Client plugin	Создайте проект с помощью плагина VRPN Client.
SPECIALS
GPU Monitor plugin	Включите мониторинг частоты и температуры графического процессора для вашего проекта.
Interface plugin	Создайте проект с помощью плагина Interface.
Kinect2 Plugin	Создайте проект с помощью плагина Kinect2 .
Leap Motion plugin	Отслеживание рук и пальцев с помощью Leap Motion
TeslaSuit plugin	Создание ощущений, отслеживание движений тела и снятие биометрических данных пользователя с помощью Teslasuit.
GEODETIC
Geodetics plugin	Плагин, позволяющий переводить GPS-координаты широты, долготы и высоты в координаты X, Y и Z и наоборот.

Дополнения#

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

1. Нажмите Add Existing на вкладке Projects.
   
2. В открывшемся диалоговом окне файла укажите путь к папке проекта и нажмите Apply. Проект появится в списке проектов.
   

Примечание

Если добавленный проект был создан в SDK предыдущей версии, он будет отмечен меткой Upgrade.

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

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

1. 

2. Выберите самую последнюю установленную версию SDK и нажмите Update Configuration.
   
3. Укажите путь к папке резервного копирования, в которую будет скопирован исходный проект. Оставьте Migrate Content отмеченным и нажмите UPGRADE PROJECT.
   

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

Примечание

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

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

• launch_debug - лаунчер отладочной версии проекта.
• launch_editor - лаунчер проекта с загруженным редактором.

• launch_release - лаунчер релизной версии проекта.

  Примечание

  Чтобы использовать программу запуска релиза, необходимо сначала перенастроить проект на бинарные файлы Release.

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

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

  

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

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

• Custom - будет запущено собственное основное приложение:

  

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

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

Настройка параметров UnigineEditor#

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

Настройка параметров IDE#

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

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

По умолчанию проект настроен на использование бинарных файлов версии Development движка, которые содержат дополнительные инструменты отладки. Бинарные файлы Development движка требуют запущенного экземпляра SDK Browser, точно так же, как и для UnigineEditor.

Вы можете запустить свое приложение без SDK Browser с помощью файла launch_release в папке проекта, но сначала необходимо перенастроить проект на использование бинарных файлов Release.

Чтобы изменить конфигурацию проекта:

1. Нажмите Other Actions -> Configure.

   

2. Выберите опцию Release в раскрывающемся списке Engine.

   

3. Нажмите кнопку Update Configuration в нижней части окна конфигурации, чтобы сохранить конфигурацию.

Как только проект будет перенастроен на сборку Release, его можно запускать без SDK Browser — запустите файл launch_release в папке проекта.

Бинарные файлы Release должны быть использованы в финальной сборке проекта.

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

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

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

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

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

• Бинарные файлы
• core.ung, editor.ung and scripts.ung
• Файлы запуска (Launchers)

Примечание

Если некоторые из файлов, перечисленных выше, изменены, к именам таких файлов добавляется постфикс .modified. При этом также будут скопированы файлы из SDK.