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
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
Учебные материалы

Unigine.BootConfig Class

A singleton that controls the Engine startup configuration and enables you to customize the boot screen.

Notice
Fonts, textures, or any other resources used in the boot screen cannot be packed into an UNG archive.

Usage Example#

By using the BootConfig class, you can customize the boot screen and change the startup settings and save them to the configuration file for the next engine start-up. For example:

AppSystemLogic.cs

Source code (C#)
using System;
using System.Collections.Generic;
using System.Linq;
using System.Reflection;
using System.Runtime.InteropServices;
using System.Text;
using Unigine;

namespace UnigineApp
{
	internal class AppSystemLogic : SystemLogic
	{

		public override bool Shutdown()
		{

			// set the window title
            BootConfig.WindowTitle = "Project Name";
            Unigine.Console.SetString("starting_world", "my_world");

            // customize the boot screen
            BootConfig.ScreenWidth = 960;
            BootConfig.ScreenHeight = 540;

            BootConfig.ScreenBackgroundColor = vec4.BLACK;
            BootConfig.ScreenTransform = new vec4(1.0f, 1.0f, 0.5f, 0.5f);

            BootConfig.ScreenThreshold = 16;
            BootConfig.ScreenTexture = "textures/boot_screen.png";

            BootConfig.ScreenText = @"
			<p align=""center"">
				<font color=""#ffffff"" size=""64"">
					<xy x=""%10"" y=""%50""/>Helicopter
				</font>
			</p>";

            BootConfig.ScreenMessageEngineInit = @"
			<p><font size=""24"" color=""#777777"">
				Engine initialization.
			</font></p>";

            BootConfig.ScreenMessageFileSystemInit = "Custom message for file system initialization.";
            BootConfig.ScreenMessageMaterialsInit = "Custom message for materials initialization.";
            BootConfig.ScreenMessagePropertiesInit = "Custom message for properties initialization.";
            BootConfig.ScreenMessageShadersCompilation = "Custom message for shaders compilation.";

            BootConfig.Save();
			
			return true;
		}
		

	}
}

See Also#

BootConfig Class

Properties

bool ScreenEnabled#

The value indicating if the boot screen is enabled.

string ScreenMessageShadersCompilation#

The message displayed on shaders compilation. The message is set the same way as the screen text.

string ScreenMessageEngineInit#

The message to be displayed on the engine initialization. The message is set the same way as the screen text.

string ScreenMessageFileSystemInit#

The message to be displayed on the file system initialization. The message is set the same way as the screen text.

string ScreenMessagePropertiesInit#

The message displayed on properties initialization.The message is set the same way as the screen text.

string ScreenMessageStaticMeshesInit#

The message to be displayed on static meshes initialization. The message is set the same way as the screen text.

string ScreenMessageMaterialsInit#

The message to be displayed on materials initialization. The message is set the same way as the screen text.

string ScreenMessageMaterialsPreloading#

The message to be displayed on materials preloading.

string ScreenText#

The text of the boot screen.

string ScreenFont#

The path to the font for text rendering.
Notice
Fonts or any other resources used in the Boot screen cannot be packed into an UNG archive.

string ScreenTexture#

The path to the boot screen texture.
Notice
Textures or any other resources used in the Boot screen cannot be packed into an UNG archive.

int ScreenThreshold#

The threshold for blending based on the alpha-channel.

vec4 ScreenTransform#

The transformation of the boot screen texture. The default value is vec4(1.0f, 1.0f, 0.5f, 0.5f).

vec4 ScreenBackgroundColor#

The background color of the screen.

int ScreenHeight#

The height of the boot screen window, in pixels.

int ScreenWidth#

The width of the boot screen window.

int NumExternPlugins#

The number of plugin libraries to be automatically loaded at the Engine startup. These plugins are specified in the .boot configuration file via the extern_plugin element. The list of these plugin paths can be obtained via the getNumExternPlugins() and getExternPlugin(int num) methods. The order of loading plugins matters, you can rearrange them via swapPluginPath().

int NumPluginPaths#

The number of directory(ies) containing plugins to be automatically loaded at the Engine startup. These directories are specified in the .boot configuration file via the plugin_path element. The list of these plugin paths can be obtained via the getNumPluginPaths() and getPluginPath(int num) methods. The order of loading plugins matters, you can rearrange the paths via swapPluginPath()

string ConsoleCommand#

The console command(s) used at the Engine startup (corresponds to the console_command element of the .boot configuration file).

string ExternDefine#

The extern define(s) used at the Engine startup (corresponds to the extern_define element of the .boot configuration file).

string SoundApp#

The sound API used (corresponds to the sound_app element of the .boot configuration file).

string VideoApp#

The graphics API used for rendering (corresponds to the video_app element of the .boot configuration file).

string SystemCache#

The path to a cache file used by the Engine (corresponds to the system_cache element of the .boot configuration file).

string EditorCache#

The path to a cache file used by the UnigineEditor (corresponds to the editor_cache element of the .boot configuration file).

string CachePath#

The path to the store system and Editor cache files(corresponds to the cache_path element of the .boot configuration file).

string EditorScript#

The path to the editor script (corresponds to the system_script element of the .boot configuration file).

string SystemScript#

The path to the system script (corresponds to the system_script element of the .boot configuration file).

string EngineLog#

The log file (in TXT format) used by the Engine. The path can be absolute or relative to the binary executable. For relative paths, if the Project Name startup parameter is set, the log file with the specified name will be created in the corresponding directory in the User profile (only the name will be used, the remaining part of the relative path will be discarded).

string GuiPath#

The path to a GUI skin used for the engine interface. The path can be specified as absolute or relatively to the data folder.

bool Autosave#

The value indicating if the startup configuration settings are automatically saved to the corresponding config file on loading, closing, and saving the world, as well as on the Engine shutdown.

string Path#

The path to the startup configuration file (default: configs/default.boot). The path can be specified as an absolute path or relative to the -data_path or <project_name> folder if the -project_name is set. To run the application with another boot configuration file, specify the path to it using the -boot_config command-line option.

string WindowTitle#

The title of the application window.

string WindowIconPath#

The path to the custom icon for the final application's window.

bool VideoQuadroSync#

Console: video_quadro_sync
The value indicating whether NVIDIA Quadro Sync feature is enabled, providing support for synchronization of frame rendering across multiple displays. Enabling this option automatically sets the view to fullscreen, enables VSYNC and sets the MaxFPS value to 0.

bool VideoOffscreen#

Console: video_offscreen
The value indicating if the offscreen mode is enabled for the application. Offscreen mode makes it possible to run UNIGINE Engine in a cloud and use powerful servers (e.g., to generate photorealistic datasets for deep learning and verification of AI algorithms).
Notice
Available only during the Engine initialization (startup), has no effect at run time.

int VideoAdapter#

Console: video_adapter
The hardware video adapter ID to be used for rendering.
Notice
Available only during the Engine initialization (startup), has no effect at run time.

bool VideoDebugShader#

Console: video_debug_shaders
The the value indicating if the debug shader shall be used for the application regardless of its binary type (debug or release). This option should be enabled in case you use graphics debugging tools (e.g., the RenderDoc debugger).

int VideoDebug#

Console: video_debug
The video debug mode for graphical API.
Notice
Beware of severe slowdown when enabled. Available only during the Engine initialization (startup), has no effect at run time.

Members


bool Load ( ) #

Console: boot_config_load
Loads Engine startup configuration from the file. To change the path to the configuration file use the setPath() method.

Return value

true if the config is successfully loaded from the file; otherwise, false.

bool Save ( ) #

Console: boot_config_save
Saves the current Engine startup configuration to the file. To change the path to the configuration file use the setPath() method.

Return value

true if the current configuration is successfully saved to the file; otherwise, false.

void Reset ( ) #

Resets the settings in the Engine startup configuration file to the default.

void RemovePluginPath ( int num ) #

Removes a plugin path with the specified number from the list of the plugin paths specified in the .boot configuration file via the plugin_path element.A plugin path is a directory containing plugins to be automatically loaded at the Engine startup.

Arguments

void SwapPluginPath ( int num0, int num1 ) #

Swaps two plugin paths with the given numbers specified in the .boot configuration file.A plugin path is a directory containing plugins to be automatically loaded at the Engine startup. The list of these plugin paths can be obtained via the getNumPluginPaths() and getPluginPath(int num) methods. The order of loading plugins matters, you can rearrange the paths via swapPluginPath()

Arguments

string GetPluginPath ( int num ) #

Returns a plugin path with the given number specified in the .boot configuration file via the plugin_path element.A plugin path is a directory containing plugins to be automatically loaded at the Engine startup. The order of loading plugins matters, you can rearrange the paths via swapPluginPath().

Arguments

Return value

Path to the plugins directory with the given number in the list of the plugin paths. Сan be absolute or specified relatively to the binary executable.

void SetPluginPath ( int num, string value ) #

Sets a new path for the item of the list of the plugin paths with the given number specified in the .boot configuration file via the plugin_path element.A plugin path is a directory containing plugins to be automatically loaded at the Engine startup. The order of loading plugins matters, you can rearrange the paths via swapPluginPath().

Arguments

  • int num - Plugin path number in the list of the specified plugin paths.
  • string value - New path to be set for the specified item of the list of the plugin paths. Сan be specified relatively to the binary executable or as an absolute path.

void RemoveExternPlugin ( int num ) #

Removes a plugin with the specified number from the list of the plugins specified in the .boot configuration file via the extern_plugin element.

Arguments

void SwapExternPlugin ( int num0, int num1 ) #

Swaps two plugins with the given numbers specified in the .boot configuration file.The list of these plugins can be obtained via the getNumExternPlugins() and getExternPlugin(int num) methods. The order of loading plugins matters, this method enables you to rearrange plugins to change loading order.

Arguments

string GetExternPlugin ( int num ) #

Returns the name of the plugin with the given number specified in the .boot configuration file via the extern_plugin element.The order of loading plugins matters, you can rearrange the paths via swapExternPlugin().

Arguments

Return value

Name of the plugin with the given number specified in the .boot configuration file. Plugin library name goes without any prefixes and postfixes (e.g., libNetwork_x64d.so is listed as "Network").

void SetExternPlugin ( int num, string value ) #

Sets a new name of the plugin with the given number specified in the .boot configuration file via the extern_plugin element.The order of loading plugins matters, you can rearrange the paths via swapExternPlugin().

Arguments

  • int num - Number of the plugin to be set in the list of the specified plugins, in the range from 0 to the total number of plugins specified.
  • string value - Name of the plugin with the given number specified in the .boot configuration file. Plugin library name goes without any prefixes and postfixes (e.g., libNetwork_x64d.so is listed as "Network").
Last update: 13.12.2024
Build: ()