This page has been translated automatically.
Видеоуроки
Интерфейс
Основы
Продвинутый уровень
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Профессиональный уровень (SIM)
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Режимы вывода изображения
Физика
Браузер SDK 2
Лицензирование и типы лицензий
Дополнения (Add-Ons)
Демонстрационные проекты
API Samples
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Контроль версий
Настройки и предпочтения
Работа с проектами
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Sandworm
Использование инструментов редактора для конкретных задач
Расширение функционала редактора
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World-ноды
Звуковые объекты
Объекты поиска пути
Player-ноды
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
Унифицированный язык шейдеров UUSL (Unified UNIGINE Shader Language)
Плагины
Форматы файлов
Материалы и шейдеры
Rebuilding the Engine Tools
Интерфейс пользователя (GUI)
Двойная точность координат
API
Animations-Related Classes
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
VR-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Визуальный редактор материалов
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Учебные материалы

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

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

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

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

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

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

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

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

  4. Укажите необходимые настройки приложения и общие настройки .
  5. Нажмите 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 2022)
      • C++ (Qt-based) - для сборки проекта требуется Qt Creator, QMake или CMake.
      • C++ (CMake)
    • В Linux:

      • C++ GNU Make
  • C# (.NET) - для реализации проекта будут использоваться C# API и Компонентная система . Для сборки проекта требуется .NET.
Precision

Используемая точность координат:

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

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

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

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

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

STEREO 3D
Dual output stereo 3D (Separate plugin) Вывод отдельных изображений для каждого глаза.
Примечание
Плагин Separate поддерживает только DirectX 11.
MULTI-MONITOR
SpiderVision
(SpiderVision plugin)
Визуализация приложения на нужном количестве мониторов или проекций или использование настройки для нескольких проекторов, сохраненной в калибровочном файле, созданном через Scalable Display Manager и настроенном через EasyBlend SDK.
3-monitor output (Surround plugin) Визуализация приложения на 3 мониторах одновременно .
NETWORK
ARTTracker plugin Создание проекта с плагином ARTTracker .
Steam plugin Создание проекта с плагином для интеграции со Steam.
Syncker plugin Создание проекта с плагином Syncker для синхронизации многоканального рендеринга.
VRPN Client plugin Создание проекта с плагином VRPN Client.
WebStream plugin Создание проекта с плагином WebStream.
SPECIALS
GPU Monitor plugin Включение мониторинг частоты и температуры графического процессора для вашего проекта.
Kinect2 Plugin Создание проекта с плагином Kinect2 .
Leap Motion plugin Отслеживание рук и пальцев с помощью Leap Motion
TeslaSuit plugin Создание ощущений, отслеживание движений тела и снятие биометрических данных пользователя с помощью Teslasuit.
Ultraleap Отслеживание рук и пальцев с помощью Ultraleap.
VCSIntegration Plugin Использование системы контроля версий (SVN, Git) для отслеживания всех изменений файлов в UNIGINE Editor.
SOUND
FMOD plugin Плагин, который обеспечивает интеграцию с библиотекой FMOD, разработанной Firelight Technologies. FMOD - это решение, которое включает в себя все инструменты, необходимые для добавления звука и музыки в видеоигры и приложения.

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

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

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

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

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

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

  1. Щелкните по метке Upgrade на изображении проекта или Other Actions -> Configure. Откроется следующая форма:

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

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

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

Запуск проекта#

Чтобы запустить проект с пользовательскими настройками, нажмите значок с тремя точками на кнопке Run:

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

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

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

Запуск проекта с пользовательскими настройками#

Чтобы запустить проект с пользовательскими настройками, нажмите значок с тремя точками на кнопке Выполнить:

Откроется форма Customize Run Options.

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

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

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

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

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

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

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

Содержимое проекта редактируется в UNIGINE Editor, код редактируется с помощью IDE.

  • Чтобы отредактировать содержимое проекта, нажмите Open Editor.

  • Для редактирования исходного кода используйте Open Code IDE. Для открытия кода будет использоваться среда IDE, выбранная по умолчанию.

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

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

Настройте параметры запуска редактора UNIGINE, нажав значок с тремя точками на кнопке Open Editor:

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

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

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

Чтобы сменить инструмент, выполните следующие действия:

  • В Windows нажмите значок с тремя точками на кнопке Open Code IDE. Откроется следующая форма:

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

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

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

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

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

  • Сборка 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.
Последнее обновление: 30.10.2024
Build: ()