Video Tutorials
Interface
Essentials
Advanced
Полезные советы
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Программирование
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
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
Работа с контентом
Content Optimization
Materials
Art Samples
Tutorials

Параметры командной строки при запуске

Параметры командной строки запуска можно указать при запуске исполняемого файла UNIGINE. Эти параметры определяют, какой API рендеринга использовать, какое разрешение установить для окна Unigine, где хранятся ресурсы для инициализации движка и т.д. Параметры задаются либо в UNIGINE SDK Browser , либо вручную через командную строку .

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

Синтаксис параметров командной строки следующий: сначала указывается полное имя двоичного исполняемого файла (64-разрядная версия для разработки или производственная версия), а затем параметры запуска.

Shell-команды
main_* -command argument
Shell-команды
main_* -command "argument,argument"
Shell-команды
main_* -console_command "command argument"

Все пути указаны как абсолютные или относительно двоичного исполняемого файла или каталога data.

Если одна и та же команда указана несколько раз, движком будет учтена только последняя команда. Например, в следующем случае движком будет использоваться только argument3:

Shell-команды
-command "argument1" -command "argument2" -command "argument3"
Примечание
  • Исключением являются параметры командной строки файловой системы : они могут накапливать все указанные значения.
  • Параметры интерфейса командной строки, указанные при запуске приложения, всегда имеют приоритет над параметрами, хранящимися в файле конфигурации. Некоторые параметры интерфейса командной строки можно изменить с помощью консоли . Такие параметры автоматически сохраняются в файле конфигурации (таким образом, после выхода из приложения они будут восстановлены при следующем запуске). Все остальные параметры интерфейса командной строки не изменяют файл конфигурации.

Настройки видео#

Имя Описание Аргументы По умолчанию
-video_mode Режим видео для установки разрешения или размера окна -1 соответствует video_width ×video_height
0 соответствует 640×360
1 соответствует 960×540
2 соответствует 1024×576
3 соответствует 1280×720
4 соответствует 1366×768
5 соответствует 1600×900
6 соответствует 1920×1080
7 соответствует 2560×1440
8 соответствует 3840×2160
9 соответствует 640×400
10 соответствует 960×600
11 соответствует 1024×640
12 соответствует 1280×800
13 соответствует 1440×900
14 соответствует 1680×1050
15 соответствует 1920×1200
16 соответствует 2560×1600
17 соответствует 640×480
18 соответствует 800×600
19 соответствует 1024×768
20 соответствует 1280×960
21 соответствует 1280×1024
22 соответствует 1600×1200
23 соответствует 2048×1536
24 соответствует 2560×2048
1
-video_width Ширина экрана
Имеет смысл, только если video_mode = -1
010000 0
-video_height Высота экрана
Имеет смысл, только если video_mode = -1
010000 0
-video_resizable Позволяет изменять размер окна на лету, без перезапуска приложения 0 - размер неизменяемый
1 - размер изменяемый
0
-video_fullscreen Полноэкранный режим 0 - оконный режим
1 - полноэкранный режим
2 - полноэкранный режим, когда окно приложения отображается без декораций
0

Настройки графики#

Имя Описание Аргументы По умолчанию
-video_app Графический API, используемый для рендеринга:
  • Без средства визуализации: ничего не отображать на экране (например, для серверов в случае игры по сети).
  • Автоматически выбирать лучший вариант из доступных
  • DirectX
  • OpenGL
Текущее значение -video_app можно получить через getVideoApp() метод Unigine API.
"null"
"auto"
"direct3d11" or "dx"
"opengl" or "gl"
"auto"
-video_adapter В случае нескольких графических процессоров позволяет выбрать используемый графический процессор.
Примечание
Доступно только для DirectX.
Номер используемого графического процессора. 0
-video_debug Включает или отключает контекст отладки OpenGL или DirectX.
Примечание
Включение контекста отладки может привести к падению производительности (~ 30-40%).
DirectX:
  • 0 , чтобы отключить
  • 1 для записи всех ошибок DirectX (красный) и предупреждений (желтый). Если ошибка возникла, значит, в API есть ошибка.
  • 2 для записи всех ошибок DirectX (красный) и предупреждений (желтый). Если произошла ошибка, движок выйдет из строя и будет показан полный стек вызовов.
OpenGL:
  • 0 , чтобы отключить
  • 1 для записи всех ошибок OpenGL (красный) и предупреждений (желтый). Если ошибка возникла, значит, в API есть ошибка.
  • 2 работает так же, как режим 1 .
0
-video_quad_buffer Включает / отключает стерео с четырехкратной буферизацией . 0 для отключения четырехъядерной буферизации
1 , чтобы включить четырехкратную буферизацию
0
-video_surround Разрешает рендеринг приложения на 3 мониторах. 0 отключить рендеринг на 3-х мониторах
1 включить рендеринг на 3-х мониторах
0
-video_surround_border Устанавливает размер компенсации лицевой панели монитора в пикселях. Он используется вместе с -video_surround 1 . Размер компенсации лицевой панели в пикселях.
-video_vsync Вертикальная синхронизация (синхронизация FPS с частотой обновления монитора) 0 - не использовать синхронизацию
1 - использовать синхронизацию
0

Файловая система#

Имя Описание Аргументы По умолчанию
-data_path Путь к каталогу data со всеми ресурсами . Путь может быть указан как абсолютный путь или относительно двоичного исполняемого файла. Указанный каталог -data_path можно получить с помощью функции getDataPath(). Аргумент можно передать следующим образом:
  • ../RELATIVE_PATH/
  • ABSOLUTE_PATH
../
-plugin_path Путь к каталогу, содержащему плагины. Все плагины в этом каталоге будут загружены автоматически при запуске. Путь может быть указан относительно двоичного исполняемого файла или как абсолютный путь. Список указанных каталогов -plugin_path можно получить с помощью методов getNumPluginPaths() и getPluginPath(int num). Аргументы могут быть переданы следующим образом:
  • ../RELATIVE_PATH/
  • ABSOLUTE_PATH
plugins/
Примечание
В отличие от других параметров командной строки, параметр plugin_path может накапливать все указанные значения. Он позволяет указать несколько путей, каждый из которых будет использоваться движком.

Для нескольких каталогов или пакетов необходимо указывать каждый элемент отдельно без запятых, например:

Исходный код
-plugin_path ../RELATIVE_PATH_1/ -plugin_path ../RELATIVE_PATH_2/ -plugin_path ABSOLUTE_PATH

Прочие данные#

Имя Описание Аргументы По умолчанию
-cache_path Путь для хранения файлов кэша системы и редактора (указывается system_cache а также editor_cache соответственно). Путь может быть указан как абсолютный путь или относительно -data_path.
Примечание
Чтобы этот параметр вступил в силу, вы должны либо удалить существующие файлы кэша system и editor , либо переместить их в новое указанное место.
Аргументы могут быть переданы следующим образом:
  • ../RELATIVE_PATH/
  • ABSOLUTE_PATH
data/
-editor_cache Путь к файлу кеша, который будет использоваться UnigineEditor. Путь может быть указан как абсолютный путь или относительно -data_path, или к -cache_path (если есть). editor.cache
-system_cache Путь к файлу кеша, который будет использоваться движком. Путь может быть указан как абсолютный путь или относительно -data_path, или к -cache_path (если есть). unigine.cache
-engine_log Файл журнала, который будет создан и использован. Путь может быть указан как абсолютный путь или относительно двоичного исполняемого файла. Для относительных путей, если установлено -project_name , файл журнала с указанным именем будет создан в соответствующем каталоге в профиле пользователя (будет использоваться только имя , оставшаяся часть относительного пути будет отброшена). log.txt
-editor_script Путь к скрипту редактора (указан относительно каталога data )
-gui_path Путь к оболочке GUI, которая будет использоваться для интерфейса движка. Путь может быть указан как абсолютный путь или относительно -data_path. core/gui/
-project_name Заставляет движок сохранять все изменяющиеся данные (файл журнала, файлы кеша и файл конфигурации) в профиле пользователя, а не в каталоге с двоичными файлами. Для этого будет создан каталог с указанным PROJECT_NAME или путем к каталогу проекта относительно профиля пользователя (например, unigine_projects/my_project). PROJECT_NAME, а именно:
  • Имя каталога проекта. Например, -project_name my_project создаст следующий каталог:

    Windows :

    C:/Users/<username>/my_project/

    Linux :

    /home/<username>/.my_project/

  • Путь к каталогу проекта относительно профиля пользователя. Например, -project_name unigine_projects/my_project создаст каталог my_project в следующем каталоге:

    Windows :

    C:/Users/<username>/unigine_projects/

    Linux :

    /home/<username>/.unigine_projects/

    Примечание
    Указанная папка unigine_projects должна существовать в профиле пользователя.
-system_script Путь к системному скрипту (указан относительно каталога данных ). core/unigine.usc
-skip_guidsdb Движок игнорирует файл guids.db и ищет идентификаторы GUID среди всех файлов .meta внутри папки данных и всех смонтированных внешних каталогов и пакетов.
Примечание
UnigineEditor использует этот аргумент по умолчанию, чтобы избежать ошибок, и всегда повторно генерирует файл guids.db, чтобы гарантировать его достоверность.

Настройки, относящиеся к движку#

Имя Описание Аргументы
-console_command Консольная команда для использования при запуске двигателя. Несколько команд можно разделить с помощью последовательности &&. command <arguments>
-extern_plugin Загрузите библиотеку плагинов (путь указывается относительно исполняемого двоичного файла).
  • Имя библиотеки не должно содержать префиксов и постфиксов.
    (Например, libNetwork_x64d.so следует передавать как "Network".)
  • Некоторые плагины разделяются запятыми (без пробелов).
  • Если вы хотите очистить список плагинов (они автоматически загружаются движком после того, как он был указан при запуске), просто передайте ""в качестве аргумента этой команды.
Аргументы можно указать следующим образом:
  • PLUGIN_NAME
  • PLUGIN_NAME_1,PLUGIN_NAME_2,...,PLUGIN_NAME_N
-extern_define Будет использоваться внешнее определение.
  • Некоторые определения разделяются запятыми (без пробелов).
  • Вы также можете использовать следующий синтаксис: -extern_define "A=B,C=D".
    (Например, -extern_define  "TEST=42" .)
  • Если вы хотите удалить все определения, просто передайте ""в качестве аргумента этой команды.
Текущее значение -extern_define можно получить через getExternDefine() метод Unigine API.
Аргументы можно указать следующим образом:
  • DEFINITION_NAME
  • DEFINITION_NAME=VALUE
  • DEFINITION_NAME_1,DEFINITION_NAME_2,
    DEFINITION_NAME_3=VALUE,...,DEFINITION_NAME_N

Настройки звука#

Имя Описание Аргументы По умолчанию
-sound_app Используемый звуковой API:
  • No sound
  • Автоматический выбор лучшего варианта звуковой библиотеки из доступных (OpenAL)
  • Библиотека звуков OpenAL
Текущее значение -sound_app можно получить через getSoundApp() метод Unigine API.
null
auto
openal
auto
Последнее обновление: 10.10.2020