# Console UNIGINE **console** is used for standard input, output and error streams for the file loading, rendering system, audio and video systems, path-finding system, physics engine, file system and many others. Can be opened in any UNIGINE-based application. ### How to Open Console A built-in console is called by pressing the **~ (tilda)** key: ![](console_sm.jpg) The console can be hidden by pressing the **~ (tilda)** key one more time. See how to assign another key [here](#intro_change_key). ### Console Operation Console operation can be either command or variable: - **Command** is a directive to a console to perform a specific task. - **Variable** is an identifier that contains some stored value. ### Command Syntax Console [command](#command) can take null, one or several **arguments**. The syntax is: ```text command_to_execute // null argument command_to_execute argument // one argument command_to_execute argument argument // two arguments ``` #### Hints - To see the current [variable](#variable) value, other acceptable values and short description, just type it and press the **Enter** key. For example, if you type the `main_window_resizable`variable, you get the following result: ```text Main window resizable toggle 0 is non-resizable mode 1 is resizable mode main_window_resizable = 1 ``` - To complete a [command](#command) or [variable](#variable) name, just start typing first letters and press the **TAB** key until you get the required result. ### How to Change the Console Opening Key If you want to change the default **~ (tilda)** console toggle key, open the user configuration file (`configs/default.user` by default) and change the *console_key* field. You can specify a key scancode or name from the [list](../../api/library/controls/class.input_cpp.md#KEY). For example, to set the **back quote** key, specify BACK_QUOTE (or 17): ```xml BACK_QUOTE ``` You can also specify *several* comma-separated keys: ```xml BACK_QUOTE,F3,18 ``` To set a *keyboard shortcut* that turns on and off the console, specify a key modifier in the *console_key_modifier* field in addition to the console key. The modifier can be set by using a modifier code or name from the [list](../../api/library/controls/class.input_cpp.md#MODIFIER). For example, to set the **Left Ctrl+`** shourtcut, change the user configuration file as follows: ```xml BACK_QUOTE LEFT_CTRL ``` > **Notice:** You can also change the console opening key or keyboard shortcut using the `console_key` and `console_key_modifier` commands while the application is executed. ## Console Basic operations on the [console](#console), [command](#command) and [variable](#variable). | bind | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Command.** Binds a key to a command. For example, to bind the **asterisk** (*****) key to the `world_reload`command, type: ```text Unigine~# bind * world_reload ``` | **Arguments:** 1. **Key** to bind 2. **Command** to execute | | clear | | | **Description:** - **Command.** Clears all messages from the console window. | | | console_key | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** Prints the scancode or the name of the current console toggle key. - **Command.** Assigns a new key to turn on or off the console. | **Arguments:** Key **scancode** or **name** from the [list](../../api/library/controls/class.input_cpp.md#KEY). Several comma-separated arguments are allowed. | | console_key_modifier | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** Prints the code or the name of the current modifier set for the console toggle key. - **Command.** Assigns a new key modifier for the console turning on and off key. | **Arguments:** Modifier **code** or **name** from the [list](../../api/library/controls/class.input_cpp.md#MODIFIER). | | help | | | **Description:** - **Command.** Prints the list of the built-in commands. | | | hide | | | **Description:** - **Command.** Hides the console. | | | ls | | | **Description:** - **Command.** Prints a set of all available console keys, commands and variables. | | | show | | | **Description:** - **Command.** Show the console. | | | switch | | | **Description:** - **Command.** Switches among all variable values. > **Notice:** Make sure that the variable is an integer. | **Arguments:** **Variable**, which values will be switched | | toggle | | | **Description:** - **Command.** Enables or disables a variable. > **Notice:** Enabled variable will have a default value. For example, if you toggle the `show_visualizer` variable, you will get the following result: ```text toggle show_visualizer show_visualizer = 0 // disabled visualizer toggle show_visualizer show_visualizer = 1 // enabled visualizer ``` | **Arguments:** **Variable** to be toggled | | unbind | | | **Description:** - **Command.** Unbinds a key from a command. | **Arguments:** **Key** to unbind | | console_limit | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current maximum number of messages the console can output. - **Command.** � Sets the maximum number of messages the console can output. | **Arguments:** **[0; INT_MAX]** - available range **16384** - by default | | console_height | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current console height in percentage of the window height. - **Command.** � Sets the console height in percentage of the window height. | **Arguments:** **[0; 100]** - available range **75** - by default | ### Console GUI Operations on the console GUI. | console_size | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints the current size for the console font. - **Command.** � Sets the size for the console font. | **Arguments:** **[4; 32]** - available range **16** - by default | | console_font | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints a current path to a `*.ttf` file used as a console font. - **Command.** Sets a path to a `*.ttf` file to be used as a console font. | **Arguments:** Path to a `*.ttf` file `core/gui/console.ttf` (by default) | | console_onscreen | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the onscreen overlay. | **Arguments:** **0** - disabled (by default) **1** - enabled | | console_onscreen_font_size | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current size for the onscreen overlay. - **Command.** � Sets the size for the onscreen overlay. | **Arguments:** **[4; 32]** - available range **14** - by default | | console_onscreen_height | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current height of the onscreen overlay in percentage of the window height. - **Command.** � Sets the height of the onscreen overlay in percentage of the window height. | **Arguments:** **[0; 100]** - available range **20** - by default | | console_onscreen_time | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current time in seconds during which the text is displayed on the screen. - **Command.** � Sets the time in seconds during which the text is displayed on the screen. | **Arguments:** **[0.0f; 100.0f]** - available range **2.0f** - by default | | console_wrapping | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables word wrapping for the Console. | **Arguments:** **0** - disabled (by default) **1** - enabled | ## Engine Basic operations on the engine. | background_update | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints the current value indicating whether the application window is *updated* when the window is *hidden* or *out of focus* (rendering frames in background). By default, your UNIGINE application stops rendering frames and updating its main window when its window goes out of focus (e.g. user switches to another window). Setting the background update mode enables constant rendering regardless of whether the application window is focused or in the background. - **Command.** � Sets the value indicating whether the application window is *updated* when the window is *hidden* or *out of focus* (rendering frames in background). By default, your UNIGINE application stops rendering frames and updating its main window when its window goes out of focus (e.g. user switches to another window). Setting the background update mode enables constant rendering regardless of whether the application window is focused or in the background. | **Arguments:** **0** - Background update is disabled. (by default) **1** - Background update is enabled (rendering is performed when the window is out of focus, but stops if the window is minimized). **2** - Background update is always enabled (rendering is performed always, regardless of the window state). | | engine_version_info | | | **Description:** - **Command.** Prints the current engine version info. | | | engine_pedantic_warnings | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Sets a value indicating whether the Engine should generate more warnings and diagnostic messages to inform the user about cases and things that are not inherently erroneous but may be considered non-optimal or risky, potentially resulting in performance issues, excessive memory consumption, and other related concerns. When enabled, the Engine shall generate all messages about moving static (immovable) nodes, unused property parameters, memory leaks, etc. | **Arguments:** **0** - disabled (by default) **1** - enabled | | quit | | | **Description:** - **Command.** Quits the engine. | | | auto_quit | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Controls automatic shutdown of the Engine after all windows are closed. When true, the Engine terminates immediately after the last window is closed. When false, the Engine remains running in the background even with no open windows, enabling use cases such as tray applications. The value cannot be changed in the Editor, since the Editor manages and closes Engine windows. | **Arguments:** **0** - disabled **1** - enabled (by default) | | splash_screen | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Sets the value indicating whether the [Splash screen](../../code/gui/screens/index.md#splash) is enabled at the engine start-up. | **Arguments:** **0** - disabled **1** - enabled (by default) | ### Engine Configuration Files General operations on the [engine configuration](../../code/configuration_file_cpp.md). | boot_config | | |---|---| | **Description:** - **Variable.** Prints the current path to the [Engine startup configuration file](../../code/configuration_file_cpp.md#boot). - **Command.** Sets a path to the [Engine startup configuration file](../../code/configuration_file_cpp.md#boot), that contains Engine startup parameters. The path can be specified as an absolute path or relative to the *[-data_path](../../code/command_line.md#data_path)* or ** folder if the *[-project_name](../../code/command_line.md#project_name)* is set. > **Notice:** Values stored in this config file are overridden by the [command-line parameters](../../code/command_line.md) specified at the Engine startup. | **Arguments:** `Path` to the Engine startup configuration file (`data/default.boot` by default) | | boot_config_autosave | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables automatic saving of current Engine startup configuration settings to the file specified by the [**boot_config**](#boot_config) variable on loading, closing, and saving the world, as well as on the Engine shutdown. | **Arguments:** **0** - disabled (by default) **1** - enabled | | boot_config_load | | | **Description:** - **Command.** Loads Engine startup configuration settings from a [configuration file](../../code/configuration_file_cpp.md#boot) specified by the [**boot_config**](#boot_config) variable (`configs/default.boot` by default). | | | boot_config_save | | | **Description:** - **Command.** Saves Engine startup configuration settings to a [configuration file](../../code/configuration_file_cpp.md#boot) specified by the [**boot_config**](#boot_config) variable (`configs/default.boot` by default). | | | config | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints the current path to the [application configuration file](../../code/configuration_file_cpp.md#config). - **Command.** Sets a path to the [application configuration file](../../code/configuration_file_cpp.md#config), that contains settings available when working with the *[Config](../../api/library/engine/class.config_cpp.md)* class in API. The path can be specified as an absolute path or relative to the *[-data_path](../../code/command_line.md#data_path)* or ** folder if the *[-project_name](../../code/command_line.md#project_name)* is set. | **Arguments:** `Path` to the application configuration file (`configs/default.config` by default) | | config_autosave | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables automatic saving of current application configuration settings to the file specified by the [**config**](#controls_config) variable on loading, closing, and saving the world, as well as on the Engine shutdown. | **Arguments:** **0** - disabled **1** - enabled (by default) | | config_load | | | **Description:** - **Command.** Loads the application configuration settings from a [configuration file](../../code/configuration_file_cpp.md#config) specified by the [**config**](#config) variable (`configs/default.config` by default). | | | config_save | | | **Description:** - **Command.** Saves the current application configuration settings to a [configuration file](../../code/configuration_file_cpp.md#config) specified by the [**config**](#config) variable (`configs/default.config` by default). | | | controls_config | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints the current path to the [controls configuration file](../../code/configuration_file_cpp.md#controls). - **Command.** Sets a path to the [controls configuration file](../../code/configuration_file_cpp.md#controls), that contains keyboard control keys and settings defining the mouse behavior. The path can be specified as an absolute path or relative to the *[-data_path](../../code/command_line.md#data_path)* or ** folder if the *[-project_name](../../code/command_line.md#project_name)* is set. | **Arguments:** `Path` to the controls configuration file (`configs/default.controls` by default) | | controls_config_autosave | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables automatic saving of current controls configuration settings to the file specified by the [**controls_config**](#controls_config) variable on loading, closing, and saving the world, as well as on the Engine shutdown. | **Arguments:** **0** - disabled **1** - enabled (by default) | | controls_config_load | | | **Description:** - **Command.** Loads controls configuration settings from a [configuration file](../../code/configuration_file_cpp.md#controls) specified by the [**controls_config**](#controls_config) variable (`configs/default.controls` by default). | | | controls_config_save | | | **Description:** - **Command.** Saves controls configuration settings to a [configuration file](../../code/configuration_file_cpp.md#controls) specified by the [**controls_config**](#controls_config) variable (`configs/default.controls` by default). | | | global_config | | | **Description:** - **Variable.** Prints the current path to the [global configuration file](../../code/configuration_file_cpp.md#global). - **Command.** Sets a path to the [global configuration file](../../code/configuration_file_cpp.md#global), that contains global project settings, such as declarations of custom surface and material parameters and custom render parameters along with their values. The path can be specified as an absolute path or relative to the *[-data_path](../../code/command_line.md#data_path)* or ** folder if the *[-project_name](../../code/command_line.md#project_name)* is set. | **Arguments:** `Path` to the global configuration file (`configs/default.global` by default) | | global_config_autosave | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables automatic saving of current global configuration settings to the file specified by the [**global_config**](#global_config) variable on loading, closing, and saving the world, as well as on the Engine shutdown. | **Arguments:** **0** - disabled (by default) **1** - enabled | | global_config_load | | | **Description:** - **Command.** Loads global configuration settings from a [configuration file](../../code/configuration_file_cpp.md#global) specified by the [**global_config**](#global_config) variable (`configs/default.global` by default). | | | global_config_save | | | **Description:** - **Command.** Saves global configuration settings to a [configuration file](../../code/configuration_file_cpp.md#global) specified by the [**global_config**](#global_config) variable (`configs/default.global` by default). | | | user_config | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints the current path to the [user configuration file](../../code/configuration_file_cpp.md#user). - **Command.** Sets a path to the [user configuration file](../../code/configuration_file_cpp.md#user), that contains various personal settings, such as helpers (wireframe, profiler, etc.). The path can be specified as an absolute path or relative to the *[-data_path](../../code/command_line.md#data_path)* or ** folder if the *[-project_name](../../code/command_line.md#project_name)* is set. | **Arguments:** `Path` to the user configuration file (`configs/default.user` by default) | | user_config_autosave | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables automatic saving of current user configuration settings to the file specified by the [**user_config**](#user_config) variable on loading, closing, and saving the world, as well as on the Engine shutdown. | **Arguments:** **0** - disabled **1** - enabled (by default) | | user_config_load | | | **Description:** - **Command.** Loads user configuration settings from a [configuration file](../../code/configuration_file_cpp.md#user) specified by the [**user_config**](#user_config) variable (`configs/default.user` by default). | | | user_config_save | | | **Description:** - **Command.** Saves user configuration settings to a [configuration file](../../code/configuration_file_cpp.md#user) specified by the [**user_config**](#user_config) variable (`configs/default.user` by default). | | ### Engine Start-Up Parameters Console variables defined on [Engine start-up](../../code/configuration_file_cpp.md#boot). > **Notice:** After changing these variables via the console, restart the Engine to apply new values. | pso_preload | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables PSO (Pipeline State Object) preloading at Engine startup. When enabled, the Engine records every PSO created during rendering into the [PSO Log](../../editor2/shaders_precompile/index.md#cache_type_pso_log). On the next launch, all recorded PSOs are pre-created before rendering begins (multi-threaded, blocks startup until complete). When disabled, no PSO Log is written or read, and all PSOs are created on demand during rendering. | **Arguments:** **0** - disabled (by default) **1** - enabled | | materials_preload | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables [creation of material variants](../../editor2/shaders_precompile/index.md#lifecycle_load_materials) at Engine startup. For each loaded material, the Engine creates additional internal copies with modified states (e.g. different culling or blending modes) to handle specific rendering scenarios. Each variant requires its own set of shader variants. When enabled, all material variants are created at startup, ensuring that subsequent shader preloading (see *[shaders_preload](#shaders_preload)*) covers the full set of required shaders. When disabled, material variants are created on demand at runtime - useful for faster iteration during development, but may cause additional shader compilation hitches. | **Arguments:** **0** - disabled **1** - enabled (by default) | | shaders_preload | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current shaders creation strategy at Engine startup. For each loaded material (including material variants), the Engine goes through all required render pass and node type combinations. - **Command.** � Sets the shaders creation strategy at Engine startup. For each loaded material (including material variants), the Engine goes through all required render pass and node type combinations. | **Arguments:** **0** - No Shader objects are created at startup. Everything is deferred to runtime - Shader objects are created from the [Shader Bytecode Cache](../../editor2/shaders_precompile/index.md#cache_type_shader) or compiled from source on demand during rendering. Fastest startup, but may cause pop-in or freezes. **1** - Shader objects are created for all variants that have compiled bytecode in the [Shader Bytecode Cache](../../editor2/shaders_precompile/index.md#cache_type_shader). Variants not found in the cache are skipped and will be handled at runtime on demand. (by default) **2** - Same as 1, but variants not found in the cache are also compiled from source. Creating a Shader object from cached bytecode is always synchronous; compilation from source is asynchronous by default (controlled by *[render_shaders_compile_mode](#render_shaders_compile_mode)*). | | shader_cache_preload | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � When enabled, all compiled shader bytecode is **decompressed** and loaded into RAM from the [Shader Bytecode Cache](../../editor2/shaders_precompile/index.md#cache_type_shader) at startup, ready to use without any disk access. When disabled (default), each shader's bytecode is read from the cache and decompressed on demand. | **Arguments:** **0** - disabled (by default) **1** - enabled | | particles_memory_preload | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints the current size of memory allocated for particles by the command below. - **Command.** Sets the size of memory allocated for particles. > **Notice:** Works only with the **Vulkan** graphics API. | **Arguments:** Memory size in Mb. The default is 50. | ## World Basic operations on world. | starting_world | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** Prints the current world to be loaded at the engine and editor start-up. - **Command.** Sets the current world to be loaded at the engine and editor start-up. | **Arguments:** A world name or a path to a world relative to the *[-data_path](../../code/command_line.md#data_path)* folder. | | world_load | | | **Description:** - Loads the specified world. A cache file can also be specified for faster application loading. | **Arguments:** 1. `Name` of the world to load (inside the `data` directory) 2. **Name** of the world cache file (optional) | | world_quit | | | **Description:** - Clears all the world data. | | | world_save | | | **Description:** - Saves the current world to a file (`*.world`). > **Notice:** Materials won't be saved on running the command. To save them, use [materials_save](#materials_save). | | | world_reload | | | **Description:** - Reloads the world. A cache file can also be specified to be reloaded. | **Arguments:** **Name** of the world cache file (optional) | | world_async_load_node_references | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � - Enables asynchronous loading of *Node References* at loading the world. | **Arguments:** **0** - disabled (by default) **1** - enabled | | world_info | | | **Description:** - Print information on all loaded nodes. This includes nodes from the world and other sources, such as cached nodes or nodes currently being loaded via AsyncQueue. When running this command from the Editor, the list may include additional nodes that are not present in the world, since the Editor keeps its own cached nodes as well. | | ### World Resources Operations, representing information on objects generated using CPU logic, such as *[ObjectGrass](../../objects/objects/grass/index.md)*, *[ObjectMeshClutter](../../objects/objects/mesh_clutter/index.md)* and *[WorldClutter](../../objects/worlds/world_clutter/index.md)* objects. | world_manager_info | | |---|---| | **Description:** - **Command.** Print general information (the number of registered/loaded resources; used memory) on world manager resources, such as: - *PathManaged* - loaded splines - *ImageManaged* - loaded images (if not fully loaded, a dummy texture or one-mipmap texture is used) - *ImageStream* - streamed mask images - *MeshStream* - streamed meshes used as an intersection mask for grass or clutters | | | world_manager_list | | | **Description:** - **Command.** Prints the list of resources handled by the world manager (mask images for *ObjectGrass* and *WorldClutter* objects), if any. | | | world_spawn_list | | | **Description:** - **Command.** Print the list of generation requests for ObjectGrass and ObjectMeshClutter nodes with the following information: - Node type - Node ID - Camera position coordinates - Frame number | | | world_manager_images_memory | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current cache memory limit for images in Mb. - **Command.** � Sets the cache memory limit for images in Mb. | **Arguments:** **[0; 8192]** - available range **128** - by default | | world_manager_meshes_memory | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current cache memory limit for meshes in Mb. - **Command.** � Sets the cache memory limit for meshes in Mb. | **Arguments:** **[0; 8192]** - available range **128** - by default | | world_moving_immovable_node_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current mode of handling attempts to move nodes having the *[Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter)* flag enabled. The Engine will warn you by default in case of any attempts to move nodes marked as *Immovable*. - **Command.** � Sets the mode of handling attempts to move nodes having the *[Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter)* flag enabled. The Engine will warn you by default in case of any attempts to move nodes marked as *Immovable*. > **Notice:** Warnings are shown only when [*engine_pedantic_warnings*](#engine_pedantic_warnings) is enabled! > > Please be aware that there are two cases when you may disable warnings and allow movement of *Immovable* nodes: > - At run-time for procedural generation of levels. This may cause some freezing but won't affect performance much. Upon completion of the generation process you should enable warnings again. > - On world initialization, this will change world loading time but won't affect overall performance. | **Arguments:** **0** - movement of nodes having the *[Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter)* flag is prohibited. **1** - movement of nodes having the *[Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter)* flag is accompanied by a warning in the Console. (by default) **2** - movement of nodes having the *[Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter)* flag is allowed (no warnings displayed). | ## Sound Operations on the sound. | sound_occlusion | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables occlusion of a sound if other nodes are found in front of the sound source. | **Arguments:** **0** - disabled **1** - enabled (by default) | | sound_reverb | | | **Description:** - **Variable.** � Prints the current sound reverberation mode. - **Command.** � Sets the sound reverberation mode. | **Arguments:** **0** - sound reverberation is disabled **1** - single-environment sound reverberation **2** - multi-environment sound reverberation (by default) | ### Sound Resources Operations on the sound resources. | sound_manager_load_samples | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables preloading sound samples on world loading (ensure there are no lags afterwards but increases loading time and memory footprint). | **Arguments:** **0** - disabled (by default) **1** - enabled | | sound_manager_info | | | **Description:** - **Command.** Prints general information on sound resources: the number of static and streamed sound sources (registered/loaded; memory used). | | | sound_manager_list | | | **Description:** - **Command.** Prints the detailed list of sound files, if any, with used space. | | | sound_manager_sample_static_memory | | | **Description:** - **Variable.** � Prints the current cache memory limit for static sound resources in Mb. - **Command.** � Sets the cache memory limit for static sound resources in Mb. | **Arguments:** **[1; 1024]** - available range **64** - by default | | sound_manager_sample_stream_memory | | | **Description:** - **Variable.** � Prints the current cache memory limit for streamed sound resources in Mb. - **Command.** � Sets the cache memory limit for streamed sound resources in Mb. | **Arguments:** **[1; 1024]** - available range **16** - by default | ## Material Manager Operations on materials. | material_manager_info | | |---|---| | **Description:** - **Command.** Prints information about all materials without a parent, and all surfaces without an assigned material. | | | render_materials_quality | | | **Description:** - **Variable.** � Prints the current quality level of the rendered materials. Depending on the specified level, a certain set of features inside graph-based materials connected to the corresponding input of a ***[Material Quality Switch](../../content/materials/graph/node_library/misc/material_quality_switch.md)*** node will be applied. - **Command.** � Sets the quality level of the rendered materials. Depending on the specified level, a certain set of features inside graph-based materials connected to the corresponding input of a ***[Material Quality Switch](../../content/materials/graph/node_library/misc/material_quality_switch.md)*** node will be applied. | **Arguments:** **0** - Low **1** - Medium **2** - High (by default) | | materials_reload | | | **Description:** - **Command.** Reloads all loaded materials and used shaders (by calling the [reloadMaterials()](../../api/library/rendering/class.materials_cpp.md#reloadMaterials_void) method). Shader variables are updated automatically. It can be called, for example, for graphics API changes to come to effect. | | | materials_reload_event | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Handles [materials reload event](../../api/library/rendering/class.materials_cpp.md#EventBeginReload) in the Editor. Disabling is unsafe. | **Arguments:** **0** - disabled **1** - enabled (by default) | | materials_save | | | **Description:** - **Command.** Saves all loaded materials. | | | shaders_create | | | **Description:** - **Command.** Creates render material variants (see *[materials_preload](#materials_preload)*) and then creates all shaders for all loaded materials. Cached shader variants are loaded from cache synchronously; uncached variants are compiled from source asynchronously. Updates the [shader cache](../../editor2/shaders_precompile/index.md) with newly compiled shaders. | | | shaders_destroy | | | **Description:** - **Command.** Removes all shaders from RAM. > **Notice:** This command can be used to clear RAM after shader cache generation. | | ## Property Manager | property_manager_info | |---| | **Description:** - **Command.** Displays a summary of all registered properties in the system along with the number of instances for each property. | ## Animation Scripts | anim_scripts_compiler | | |---|---| | **Description:** - **Variable.** � Prints the current index of the active C++ compiler used for building animation scripts. Automatically set to -1 when no compiler is detected. If multiple compilers are available, you can switch between them by setting this value. - **Command.** � Sets the index of the active C++ compiler used for building animation scripts. Automatically set to -1 when no compiler is detected. If multiple compilers are available, you can switch between them by setting this value. | **Arguments:** **[-1; 1]** - available range **-1** - by default | | anim_scripts_build_pdb | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables PDB generation for debugging animation graph scripts (Windows only). The first build with PDB succeeds, but subsequent rebuilds are blocked because the debugger holds the PDB file. To rebuild again, restart the application. | **Arguments:** **0** - disabled (by default) **1** - enabled | | anim_scripts_preview_build | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables preview build mode for animation scripts: the scripts are compiled without optimizations, which makes rebuilds faster at the cost of slower runtime execution. The editor enables this mode automatically for fast iteration, while a built application uses fully optimized scripts. Override it only for special cases, such as profiling optimized scripts in the editor or testing a fast build in a running application. The same setting is available via the AnimScript class API. | **Arguments:** **0** - disabled (by default) **1** - enabled | | anim_scripts_compiler_path | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints the current path to the custom compiler. - **Command.** Sets the path to a custom C++ compiler used for building animation graph scripts. Use this when the compiler is installed in a non-standard location and automatic detection does not find it. | **Arguments:** Path to a `*.bat` setup script (Windows) or `g++` binary (Linux). Relative paths are resolved against the `bin/` directory. | | anim_scripts_show_compilers | |---| | **Description:** - **Command.** Prints a list of all detected C++ compilers and marks the currently active one. Useful for diagnosing why animation graph compilation is not working. | | anim_scripts_rebuild | | **Description:** - **Command.** Manually triggers a rebuild of the animation scripts library. Equivalent to [Animations::rebuildAnimScripts()](../../api/library/animations/class.animations_cpp.md#rebuildAnimScripts_void). | | anim_scripts_rebuild_and_quit | | **Description:** - **Command.** Rebuilds the animation scripts library and then quits the engine. Useful for automated (headless) rebuilds. | ## Camera Operations for fast positioning of the game camera. | camera_get | | |---|---| | **Description:** - **Command.** Returns the current position of the game camera and its rotation (Euler angles). | | | camera_set | | | **Description:** - **Command.** Set position and rotation (Euler angles) of the game camera. > **Notice:** Position and rotation of the game camera can be changed only if the camera is [unlocked](../../editor2/camera_settings/index.md#position_camera). ```text camera_set 20.0 19.0 3.0 0.0 45.0 90.0 ``` | **Arguments:** The first 3 arguments set position. The second 3 arguments set rotation (optional) | ## File System Operations on the [File system](../../principles/filesystem/index_cpp.md). | filesystem_clear_paths | | |---|---| | **Description:** - **Command.** Removes all non-existent file system paths. | | | filesystem_mmap | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables the use of memory-mapped files for faster access. | **Arguments:** **0** - disabled **1** - enabled (by default) | | filesystem_reload | | | **Description:** - **Command.** Reloads the file system, thereby update the list of files. | | | filesystem_save_guids | | | **Description:** - **Command.** Saves all file system guids to the specified file path in JSON format, or binary format if the corresponding flag is set. | **Arguments:** 1. `Path` to the file 2. **Binary** flag - save guids to a file in binary format (optional) | ### File System Info Operations, representing information on the File system. | filesystem_guids | |---| | **Description:** - **Command.** Prints the list of all file system guids. | | filesystem_info | | **Description:** - **Command.** Print general file system information (the total number of files and files per package). | | filesystem_list | | **Description:** - **Command.** Print the list of all files. | ## Assets Operations on assets. | assets_info | |---| | **Description:** - **Command.** Prints information on the number of [non-native assets](../../editor2/assets_workflow/assets_runtimes.md) and runtime files generated for them. | | assets_list | | **Description:** - **Command.** Prints the list of all [non-native assets](../../editor2/assets_workflow/assets_runtimes.md) and information on runtime files generated for them (file path, alias). | ## Import and Export Operations representing information on importers and exporters of models. | import_info | |---| | **Description:** - **Command.** Prints information on the registered importers of the models and the processors. The information includes an importer vendor name, an importer name, an extension and a priority. | | export_info | | **Description:** - **Command.** Prints information on the registered exporters of the models. | ## Asynchronous Operations Asynchronous operations. | async_log_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints the current mode for printing the list of asynchronous operations (loading / unloading of images, meshes, files, etc.) related to the specified engine component. - **Command.** � Sets the mode for printing the list of asynchronous operations (loading / unloading of images, meshes, files, etc.) related to the specified engine component. > **Notice:** - Available for debug builds only, won't work for release builds. > - You can [specify](#async_log_priority) whether only loading and unloading operations, or all operations should be shown. | **Arguments:** **0** - do not print (by default) **1** - print operations with the nodes **2** - print operations with the renderer resources (loading / unloading of meshes and textures) **3** - print operations with the file system resources (loading / unloading of files) **4** - print all operations with the nodes, renderer and file systems resources | | async_log_priority | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current scope of asynchronous operations to be shown via `async_log_mode`: only loading and unloading operations or all operations. - **Command.** � Sets the scope of asynchronous operations to be shown via `async_log_mode`: only loading and unloading operations or all operations. | **Arguments:** **0** - print only frequently used operations (by default) **1** - print all operations | | async_queue_info | | | **Description:** - **Command.** Prints the info on async queue resource count and memory usage. | | | async_queue_list | | | **Description:** - **Command.** Prints the list of async queue resources. | | | async_queue_clear | | | **Description:** - **Command.** Clears the async queue. | | ## Navigation Worker and budget settings of the experimental navigation system. The budgets bound the per-frame cost of streaming and of rebuilding tiles, so that a world whose walkable space keeps changing does not stall the frame. Visualization of the navigation meshes is covered by the [Navigation Debugging](#experimental_navigation_show_mesh) variables. | experimental_navigation_bake_num_workers | | |---|---| | **Description:** - **Variable.** � Prints the current number of worker threads a navigation mesh bake is allowed to spread its tiles over. - **Command.** � Sets the number of worker threads a navigation mesh bake is allowed to spread its tiles over. | **Arguments:** - **0** - every worker of the background pool (default) - **1 .. 256** - the given number of workers | | experimental_navigation_corridor_num_workers | | | **Description:** - **Variable.** � Prints the current number of worker threads the once-a-frame corner batch of the navigation corridors is allowed to spread its corridors over. - **Command.** � Sets the number of worker threads the once-a-frame corner batch of the navigation corridors is allowed to spread its corridors over. | **Arguments:** - **-1** - every worker of the background pool (default) - **0 .. 256** - the given number of workers | | experimental_navigation_streaming_budget | | | **Description:** - **Variable.** � Prints the current time per frame given to loading and unloading the tiles of the navigation meshes, in seconds. - **Command.** � Sets the time per frame given to loading and unloading the tiles of the navigation meshes, in seconds. | **Arguments:** **[0; 1]** - available range **0.002** - by default | | experimental_navigation_invalidate_budget | | | **Description:** - **Variable.** � Prints the current time per frame given to rebuilding the tiles that area volumes and moved obstacles have made dirty, in seconds. - **Command.** � Sets the time per frame given to rebuilding the tiles that area volumes and moved obstacles have made dirty, in seconds. | **Arguments:** **[0; 1]** - available range **0.004** - by default | | experimental_navigation_streaming_memory_limit | | | **Description:** - **Variable.** � Prints the current amount of memory the tiles and the voxels of all navigation meshes together are allowed to hold, in megabytes. Once the limit is reached, tiles stop being loaded and queries in the affected region start failing for lack of data. - **Command.** � Sets the amount of memory the tiles and the voxels of all navigation meshes together are allowed to hold, in megabytes. Once the limit is reached, tiles stop being loaded and queries in the affected region start failing for lack of data. | **Arguments:** - **0** - no limit (default) - **1 and above** - the given number of megabytes | ## Visualizer Operations on the visualizer. > **Notice:** To debug the world and objects in it, the `show_visualizer` command should be set to **1**. | show_visualizer | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints the current visualizer mode. - **Command.** � Sets the visualizer mode. It specifies if the visualizer geometry (bounding volumes, wireframe, physics bodies and shapes, etc.) is shown. | **Arguments:** **0** - visualizer is not shown (by default) **1** - visualizer is shown with depth testing (to check if other objects in the scene do not occlude visualized geometry) **2** - visualizer is shown without depth testing (visualized geometry is rendered in front of all objects in the scene) | | show_fps | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current FPS counter display mode. - **Command.** � Sets the FPS counter display mode. | **Arguments:** **0** - hide the FPS counter (by default) **1** - display the FPS counter **2** - display the FPS counter and statistics on the last 600 frames: minimum FPS, maximum FPS and average FPS for the last 600 frames. | | visualizer_fix_flicker | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Reduces wireframe visualizer flickering when [TAA](#render_taa) is on. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_wireframe_antialiasing | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables antialiasing of wireframes. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ffp_antialiasing_lines | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables antialiasing of the Visualizer and other FFP lines. | **Arguments:** **0** - disabled **1** - enabled (by default) | ### World Debugging Operations on the world debugging. | world_show_spatial | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the scene spatial tree. | **Arguments:** **0** - disabled (by default) **1** - enabled | | world_show_visualizer | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** Prints the list of node types for which the visualizer is displayed. - **Command.** Sets the node types for which the visualizer is displayed. | **Arguments:** all world field light decal object player physical navigation obstacle sound "" - to hide all handlers | | render_show_triangles | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current wireframe mode for scene triangles. - **Command.** � Sets the wireframe mode for scene triangles. | **Arguments:** **0** - triangles are hidden (by default) **1** - front faces with the depth test are shown **2** - front faces without the depth test are shown **3** - front and back faces without the depth test are shown | ### Lighting Debugging Operations on the lighting debugging. | render_show_lightmap_checker | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables the *Baked Lightmap Checker* debug mode. This mode maps the checker texture onto the baked lightmap polygons, which can be used to facilitate the process of comparing UV map texels on neighboring planes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_voxel_probe_visualizer | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of visualizer for Voxel Probes (shown for the selected probe only). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_voxel_probe_visualizer_grid_size | | | **Description:** - **Variable.** � Prints the current size of the grid that is used to visualize Voxel Probes (number of spheres along the axis). - **Command.** � Sets the size of the grid that is used to visualize Voxel Probes (number of spheres along the axis). | **Arguments:** **[7; 40]** - available range **15** - by default | | render_show_voxel_probe_visualizer_sphere_scale | | | **Description:** - **Variable.** � Prints the current scale factor of the sphere that is used to visualize Voxel Probes. The sphere size depends on the scale factor and the voxel size. - **Command.** � Sets the scale factor of the sphere that is used to visualize Voxel Probes. The sphere size depends on the scale factor and the voxel size. | **Arguments:** **[0.0f; 1.0f]** - available range **0.25f** - by default | ### Node Debugging Operations on the node debugging. | world_show_handler | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** Prints the value indicating if node handlers for lights, particle systems and so on are displayed. - **Command.** Displays node handlers for lights, particle systems, etc. | **Arguments:** The node type: - all - world - field - light - decal - object - player - physical - navigation - obstacle - sound - "" - to hide all handlers | | world_handler_3d | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current world handlers icon type to be used. - **Command.** � Sets the world handlers icon type to be used. | **Arguments:** **0** - screen scale (by default) **1** - 3D | | world_handler_distance | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current world handlers visibility distance. - **Command.** � Sets the world handlers visibility distance. | **Arguments:** **[0; inf]** - available range **500** - by default | | render_show_decals | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the wireframe for decals. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_immovable | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current value visualizing the state of the [Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter) option for objects. - **Command.** � Sets the value visualizing the state of the [Immovable](../../editor2/node_parameters/transformation_common/index.md#clutter) option for objects. | **Arguments:** **0** - disabled (by default) **1** - show objects with *Immovable* option enabled **2** - show objects with *Immovable* option disabled | | render_show_nodes_interaction_trigger | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the visualizer is enabled for nodes with the *Trigger Interaction* flag enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_nodes_interaction_clutter | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the visualizer is enabled for nodes with the *Clutter Interaction* flag enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_nodes_interaction_grass | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the visualizer is enabled for nodes with the *Grass Interaction* flag enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Landscape Terrain Debugging Operations on the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) debugging. | render_show_landscape_albedo | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables visualization of albedo data of a Landscape Terrain. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_landscape_mask | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current visualization of a detail mask of a Landscape Terrain. - **Command.** � Sets the visualization of a detail mask of a Landscape Terrain. | **Arguments:** **0** - mask vizualization is disabled (by default) **1** - DetailMask 0 **2** - DetailMask 1 **3** - ... **4** - DetailMask 19 | | render_show_landscape_terrain_vt_streaming | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables visualization of tiles being streamed. In this mode colored areas show the tiles that are currently being rendered in a lower resolution until the highest MIP-level is loaded. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_clusters | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for *Mesh Cluster* objects. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_field_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_field_mask_bits) of the [field mask](../../principles/bit_masking/index.md#field_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_field_mask_bits | | | **Description:** value indicating which bit or bits of the [field mask](../../principles/bit_masking/index.md#field_mask) are used for visualization. The surfaces that use the specified bits of the field mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_field_mask](#render_show_field_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_shadow_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_shadow_mask_bits) of the [shadow mask](../../principles/bit_masking/index.md#shadow_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_shadow_mask_bits | | | **Description:** value indicating which bit or bits of the [shadow mask](../../principles/bit_masking/index.md#shadow_mask) are used for visualization. The surfaces that use the specified bits of the shadow mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_shadow_mask](#render_show_shadow_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_obstacle_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_obstacle_mask_bits) of the [obstacle mask](../../principles/bit_masking/index.md#obstacle_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_obstacle_mask_bits | | | **Description:** value indicating which bit or bits of the [obstacle mask](../../principles/bit_masking/index.md#obstacle_mask) are used for visualization. The surfaces that use the specified bits of the obstacle mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_obstacle_mask](#render_show_obstacle_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_material_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_material_mask_bits) of the [material mask](../../principles/bit_masking/index.md#material_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_material_mask_bits | | | **Description:** value indicating which bit or bits of the [material mask](../../principles/bit_masking/index.md#material_mask) are used for visualization. The surfaces that use the specified bits of the material mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_material_mask](#render_show_material_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_viewport_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_viewport_mask_bits) of the [viewport mask](../../principles/bit_masking/index.md#viewport). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_viewport_mask_bits | | | **Description:** value indicating which bit or bits of the [viewport mask](../../principles/bit_masking/index.md#viewport) are used for visualization. The surfaces that use the specified bits of the viewport mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_viewport_mask](#render_show_viewport_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_navigation_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_navigation_mask_bits) of the [navigation mask](../../principles/bit_masking/index.md#navigation_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_navigation_mask_bits | | | **Description:** value indicating which bit or bits of the [navigation mask](../../principles/bit_masking/index.md#navigation_mask) are used for visualization. The surfaces that use the specified bits of the navigation mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_navigation_mask](#render_show_navigation_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_intersection_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_intersection_mask_bits) of the [intersection mask](../../principles/bit_masking/index.md#intersection_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_intersection_mask_bits | | | **Description:** value indicating which bit or bits of the [intersection mask](../../principles/bit_masking/index.md#intersection_mask) are used for visualization. The surfaces that use the specified bits of the intersection mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_intersection_mask](#render_show_intersection_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_sound_reverb_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_sound_reverb_mask_bits) of the [reverberation mask](../../principles/bit_masking/index.md#reverb_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_sound_reverb_mask_bits | | | **Description:** value indicating which bit or bits of the [reverberation mask](../../principles/bit_masking/index.md#reverb_mask) are used for visualization. The surfaces that use the specified bits of the reverberation mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_sound_reverb_mask](#render_show_sound_reverb_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_sound_source_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_sound_source_mask_bits) of the [sound source mask](../../principles/bit_masking/index.md#source_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_sound_source_mask_bits | | | **Description:** value indicating which bit or bits of the [sound source mask](../../principles/bit_masking/index.md#source_mask) are used for visualization. The surfaces that use the specified bits of the sound source mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_sound_source_mask](#render_show_sound_source_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_sound_occlusion_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_sound_occlusion_mask_bits) of the [sound occlusion mask](../../principles/bit_masking/index.md#sound_occlusion_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_sound_occlusion_mask_bits | | | **Description:** value indicating which bit or bits of the [sound occlusion mask](../../principles/bit_masking/index.md#sound_occlusion_mask) are used for visualization. The surfaces that use the specified bits of the sound occlusion mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_sound_occlusion_mask](#render_show_sound_occlusion_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_visualizer_distance | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current distance from the camera within which the helpers are visualized. - **Command.** � Sets the distance from the camera within which the helpers are visualized. | **Arguments:** **[0; 100000]** - available range **500** - by default | | render_show_visualizer_on_invisible_surfaces | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Displays visualizers on surfaces hidden in the viewport when the camera and surface use [different viewport masks](../../principles/bit_masking/index.md#viewport). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_complex_shadow_shader | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for objects that cast shadows in the following way: the pixels are cut out during the shadow pass, as it's done in Alpha Test or Alpha Blend materials, materials assigned to animated Mesh Skinned, opaque materials with the enabled Depth Offset or any other effects that affect shadows. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_surface_custom_texture_not_available | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces the materials of which use the [surface custom texture](../../content/materials/graph/node_library/textures/surface_custom_texture.md) in the material graph, however the option is not enabled for the surface. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_surface_custom_texture_not_used | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces with the [surface custom texture](../../content/materials/graph/node_library/textures/surface_custom_texture.md) enabled and/or set, but not used in the material graph. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_surface_custom_texture | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces with the [surface custom texture](../../content/materials/graph/node_library/textures/surface_custom_texture.md) enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_intersection | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces with the *[Intersection](../../editor2/node_parameters/physics/index.md#surface_intersection)* enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_manual_materials | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for objects with manual materials. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_non_manual_materials | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for objects with non-manual materials. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Physics Debugging | physics_show_collision_surfaces | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of collision surfaces. | **Arguments:** **0** - disabled (by default) **1** - enabled | | physics_show_contacts | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of contact points between physical bodies. | **Arguments:** **0** - disabled (by default) **1** - enabled | | physics_show_joints | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of joints between physical bodies. | **Arguments:** **0** - disabled (by default) **1** - enabled | | physics_show_shapes | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current Switches the mode of displaying collision shapes for physical bodies. - **Command.** � Sets the Switches the mode of displaying collision shapes for physical bodies. | **Arguments:** **0** - collision shapes are not shown (by default) **1** - collision shapes are rendered in wireframe mode **2** - collision shapes are rendered in solid mode | | physics_show_shapes_distance | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current distance from the camera within which the physics shapes are visualized. - **Command.** � Sets the distance from the camera within which the physics shapes are visualized. | **Arguments:** **[0; 2000]** - available range **500** - by default | | render_show_physical_exclusion_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_physical_exclusion_mask_bits) of the [physical exclusion mask](../../principles/bit_masking/index.md#exclusion_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_physical_exclusion_mask_bits | | | **Description:** value indicating which bit or bits of the [physical exclusion mask](../../principles/bit_masking/index.md#exclusion_mask) are used for visualization. The surfaces that use the specified bits of the physical exclusion mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_physical_exclusion_mask](#render_show_physical_exclusion_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_physics_intersection | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces with the *[physics intersection](../../editor2/node_parameters/physics/index.md#surface_physics_intersection)* enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_physics_intersection_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_physics_intersection_mask_bits) of the [physics intersection mask](../../principles/bit_masking/index.md#physics_intersection_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_physics_intersection_mask_bits | | | **Description:** value indicating which bit or bits of the [physics intersection mask](../../principles/bit_masking/index.md#physics_intersection_mask) are used for visualization. The surfaces that use the specified bits of the physics intersection mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_physics_intersection_mask](#render_show_physics_intersection_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_physical_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_physical_mask_bits) of the [physical mask](../../principles/bit_masking/index.md#physical_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_physical_mask_bits | | | **Description:** value indicating which bit or bits of the [physical mask](../../principles/bit_masking/index.md#physical_mask) are used for visualization. The surfaces that use the specified bits of the physical mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_physical_mask](#render_show_physical_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | | render_show_collision_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is enabled to highlight the surfaces that use the [specified bits](#render_show_collision_mask_bits) of the [collision mask](../../principles/bit_masking/index.md#collision_mask). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_collision_mask_bits | | | **Description:** value indicating which bit or bits of the [collision mask](../../principles/bit_masking/index.md#collision_mask) are used for visualization. The surfaces that use the specified bits of the collision mask will be highlighted. To use this option, rendering of the relevant visualizer *[render_show_collision_mask](#render_show_collision_mask)* should be enabled. > **Notice:** Please note that the argument is an integer value, so the bit mask has to be represented accordingly. | | ### Navigation Debugging Visualization of the navigation meshes baked by the experimental navigation system. These variables are unrelated to `render_show_navigation_mask`, which highlights scene surfaces by the bits of the legacy Navigation mask. | experimental_navigation_show_mesh | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the baked navigation meshes, in addition to the node types listed in `world_show_visualizer`. | **Arguments:** **0** - disabled **1** - enabled (by default) | | experimental_navigation_show_mesh_mode | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current Switches the drawing mode of the navigation mesh visualizer. - **Command.** � Sets the Switches the drawing mode of the navigation mesh visualizer. | **Arguments:** **0** - solid fill **1** - solid fill with wireframe (by default) **2** - wireframe only | | experimental_navigation_show_mesh_depth_test | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables depth testing for the navigation mesh visualizer, so that the mesh is occluded by the scene geometry instead of being drawn on top of it. | **Arguments:** **0** - disabled (by default) **1** - enabled | | experimental_navigation_show_mesh_tiles | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the tile borders of the navigation meshes as white edges. Useful for checking the tile size before baking a large world. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Texture Debugging Operations on the texture debugging. | render_show_texture_resolution | | |---|---| | **Description:** - **Variable.** � Prints the current display mode for texture resolution used by the renderer. - **Command.** � Sets the display mode for texture resolution used by the renderer. | **Arguments:** **0** - disabled (by default) **1** - show surfaces depending on maximum resolution of textures used in materials assigned to them applying colors in accordance with the scale **2** - show the relationship between maximum texture resolution of the material to the size of triangles on the screen to which it is applied: blue indicates insufficient texture resolution, while yellow tells that it is excessive, if the color is green - everything is ok. | | render_show_texture_resolution_blend | | | **Description:** - **Variable.** � Prints the current value used for blending the rendered image with the color displaying the texture resolution. - **Command.** � Sets the value used for blending the rendered image with the color displaying the texture resolution. | **Arguments:** **[0; 1]** - available range **0.5** - by default | | render_show_texture_resolution_uv_mode | | | **Description:** - **Variable.** � Prints the current UV channel to be used for [visualization of the texture resolution](#ShowTextureResolution). - **Command.** � Sets the UV channel to be used for [visualization of the texture resolution](#ShowTextureResolution). | **Arguments:** **0** - UV0 (by default) **1** - UV1 | | render_show_texture_resolution_streaming_accounting_mode | | | **Description:** - **Variable.** � Prints the current streaming accounting mode. The following modes are available: - *Actual Resolution* renders texel density based on the actual streaming result. - *Requested Texture Resolution* renders texel density for the current surface only, based on the surface texture resolution requested by the streaming system. - *Source Texture Resolution* renders texel density relative to the 0 mip level of the texture as if mipmap loading is disabled in the streaming system. This mode helps determine if the source texture resolution should be reduced. - **Command.** � Sets the streaming accounting mode. The following modes are available: - *Actual Resolution* renders texel density based on the actual streaming result. - *Requested Texture Resolution* renders texel density for the current surface only, based on the surface texture resolution requested by the streaming system. - *Source Texture Resolution* renders texel density relative to the 0 mip level of the texture as if mipmap loading is disabled in the streaming system. This mode helps determine if the source texture resolution should be reduced. | **Arguments:** **0** - Actual Resolution (by default) **1** - Requested Texture Resolution **2** - Source Texture Resolution | ### Vertex Color Debugging Operations on vertex color debugging. | render_show_vertex_color | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints the current value indicating whether displaying of geometry that uses the selected vertex color is enabled. - **Command.** � Sets the value indicating whether displaying of geometry that uses the selected vertex color is enabled. | **Arguments:** **0** - disabled. (by default) **1** - Red color. **2** - Green color. **3** - Blue color. **4** - Alpha color. **5** - RGB color. | ### Vertex Density Debugging Operations on the Vertex Density debugging. | render_show_vertex_density_enabled | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer enabled state. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_vertex_density_mode | | | **Description:** - **Variable.** � Prints the current mode of the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer. The following modes are available: - *Discrete Threshold* - highlights in red only the areas where the vertex density exceeds the specified threshold within the defined area. - *Gradient* - displays a color gradient representing vertex density from black (0) to **white (*[setShowVertexDensityThreshold_int_void](#setShowVertexDensityThreshold_int_void)*)** within the defined searching area. - **Command.** � Sets the mode of the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer. The following modes are available: - *Discrete Threshold* - highlights in red only the areas where the vertex density exceeds the specified threshold within the defined area. - *Gradient* - displays a color gradient representing vertex density from black (0) to **white (*[setShowVertexDensityThreshold_int_void](#setShowVertexDensityThreshold_int_void)*)** within the defined searching area. | **Arguments:** **0** - Discrete threshold (by default) **1** - Gradient | | render_show_vertex_density_depth_test | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* depth testing enabled state. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_show_vertex_density_search_area | | | **Description:** - **Variable.** � Prints the current size of the vertex search area (in pixels). - **Command.** � Sets the size of the vertex search area (in pixels). | **Arguments:** **[1; 1024]** - available range **8** - by default | | render_show_vertex_density_threshold | | | **Description:** - **Variable.** � Prints the current threshold value of the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer. - **Command.** � Sets the threshold value of the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer. | **Arguments:** **[1; 1000000]** - available range **100** - by default | | render_show_vertex_density_blend | | | **Description:** - **Variable.** � Prints the current opacity of the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer. - **Command.** � Sets the opacity of the *[Vertex Density](../../content/optimization/geometry/vertex_density/index.md#tool_overview)* visualizer. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | ### Overdraw Debugging Operations on the quad overdraw debugging. | render_show_quad_overdraw_enabled | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer enabled state. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_quad_overdraw_display_mode | | | **Description:** - **Variable.** � Prints the current display mode of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. The following display modes are available: - *Gradient* - displays a color gradient representing overdraw intensity from black (0) to **white (*[setShowQuadOverdrawThreshold_int_void](#setShowQuadOverdrawThreshold_int_void)*)**. - *Discrete threshold* - highlights in red only the areas where the overdraw exceeds the specified threshold. - **Command.** � Sets the display mode of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. The following display modes are available: - *Gradient* - displays a color gradient representing overdraw intensity from black (0) to **white (*[setShowQuadOverdrawThreshold_int_void](#setShowQuadOverdrawThreshold_int_void)*)**. - *Discrete threshold* - highlights in red only the areas where the overdraw exceeds the specified threshold. | **Arguments:** **0** - Gradient (by default) **1** - Discrete threshold | | render_show_quad_overdraw_passes | | | **Description:** - **Variable.** � Prints the current operating mode of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. The following options are available: - *All Passes with Depth Pre-Pass* (default) - Displays the total number of overdraws, including all passes (*Auxiliary, Emission, Ambient, Light*, and others), and depth pre-passes. - *Single Geometry Pass with Depth Pre-Pass* - Displays the number of overdraws for the primary rendering pass of the content after applying the depth pre-pass. Separate passes (such as Auxiliary or Emission) are not counted in this mode. - *Single Geometry Pass without Depth Pre-Pass* - Displays the number of content overdraws without using depth pre-pass (before any early depth rejection is applied). - **Command.** � Sets the operating mode of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. The following options are available: - *All Passes with Depth Pre-Pass* (default) - Displays the total number of overdraws, including all passes (*Auxiliary, Emission, Ambient, Light*, and others), and depth pre-passes. - *Single Geometry Pass with Depth Pre-Pass* - Displays the number of overdraws for the primary rendering pass of the content after applying the depth pre-pass. Separate passes (such as Auxiliary or Emission) are not counted in this mode. - *Single Geometry Pass without Depth Pre-Pass* - Displays the number of content overdraws without using depth pre-pass (before any early depth rejection is applied). | **Arguments:** **0** - All Passes with Depth Pre-Pass (by default) **1** - Single Geometry Pass with Depth Pre-Pass **2** - Single Geometry Pass without Depth Pre-Pass | | render_show_quad_overdraw_wireframe | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the Wireframe rendering enabled state in the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_quad_overdraw_landscape_terrain | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the *[Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md)* rendering enabled state in the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_quad_overdraw_water_global | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the *[Water Global](../../objects/objects/water/water_object.md)* rendering enabled state in the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_quad_overdraw_threshold | | | **Description:** - **Variable.** � Prints the current threshold value of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. - **Command.** � Sets the threshold value of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. | **Arguments:** **[1; 1000000]** - available range **40** - by default | | render_show_quad_overdraw_blend | | | **Description:** - **Variable.** � Prints the current opacity of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. - **Command.** � Sets the opacity of the *[Quad Overdraw](../../content/optimization/geometry/quad_overdraw/index.md#tool_overview)* visualizer. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | ### Occlusion Debugging Operations on the occlusion debugging, including occluder objects and occlusion queries. | render_show_occluder | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the buffer used for occluders shown in the viewport. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_queries | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of occlusion query boxes. > **Notice:** Make sure that the *Culled by occlusion query* flag is set for nodes. | **Arguments:** **0** - disabled (by default) **1** - enabled | ## Performance Profiling Operations on the [Performance profiler](../../tools/profiling/profiler/index.md). | show_profiler | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the Performance profiler. | **Arguments:** **0** - disabled **1** - enabled (by default) | | show_profiler_charts | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of Performance profiler's charts. | **Arguments:** **0** - disabled **1** - enabled (by default) | | show_profiler_table | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of Performance profiler's table. | **Arguments:** **0** - disabled **1** - enabled (by default) | | show_profiler_experimental_navigation | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the experimental navigation performance profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_profiler_generic | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the generic performance profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_profiler_memory | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the memory performance profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_profiler_memory_object | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � - **Variable.** Memory usage per node type profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_profiler_physics | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the physics performance profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_profiler_render | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the rendering performance profiler. | **Arguments:** **0** - disabled **1** - enabled (by default) | | show_profiler_thread | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the thread performance profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_profiler_world | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the world management performance profiler. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Profiler GUI Operations on the [Performance profiler](../../tools/profiling/profiler/index.md) style. | profiler_size | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints the current size for the profiler font. - **Command.** � Sets the size for the profiler font. | **Arguments:** **[4; 32]** - available range **13** - by default | | profiler_font | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints a current path to a `*.ttf` file used as a profiler font. - **Command.** Sets a path to a `*.ttf` file to be used as a profiler font. | **Arguments:** Path to a `*.ttf` file `core/gui/font.ttf` (by default) | ### Microprofile Operations on the [Microprofile](../../tools/profiling/microprofile/index_cpp.md). | microprofile_enabled | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables Microprofile. | **Arguments:** **0** - disabled **1** - enabled (by default) | | microprofile_info | | | **Description:** - **Command.** Prints the Microprofile settings: If the application is [compiled without Microprofile](../../tools/profiling/microprofile/index_cpp.md#run), the corresponding message will be printed to the console. - Maximum number of frames that can be profiled - Number of [dump frames](#microprofile_dump_frames) - Flag indicating if GPU profiling is enabled - Web server status - Web server port - Number of [webserver frames](#microprofile_webserver_frames) | | | microprofile_webserver_frames | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current number of frames to be visualised in your Web browser. - **Command.** � Sets the number of frames to be visualised in your Web browser. | **Arguments:** **[1; 500]** - available range **200** - by default | | microprofile_dump_frames | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current number of frames to be included in the Microprofile dump. - **Command.** � Sets the number of frames to be included in the Microprofile dump. | **Arguments:** **[1; 500]** - available range **500** - by default | | microprofile_dump_html | | | **Description:** - **Command.** Saves the Microprofile dump to an `.html` file. If the path isn't specified, the dump is saved to `data/microprofile_dump_html` folder. | **Arguments:** Path to an **.html** file. | ### Profiler Dump Operations on the [Profiler Dump](../../tools/profiling/profiler_dump/index_cpp.md). | profiling_start | | |---|---| | **Description:** Starts collecting a profiler dump to the specified file path. The profiler dump contains per-frame runtime performance data that can be later analyzed using the *[ProfilerDump](../../api/library/engine/class.profilerdump_cpp.md) class*. Recording continues until either the *[*stopProfilerDump()*](../../api/library/engine/class.profiler_cpp.md#stopProfilerDump_void)* method or the [profiling_stop](../../code/console/index.md#profiling_stop) command is called. **Arguments:** - *string* **path** - The file path where the profiler dump will be written. You can specify an absolute path or a path relative to *[profiling_dump_dir](../../code/console/index.md#profiling_dump_dir)*. If the path isn't specified, the profiler dump will be saved to: `profiling_dump_dir/profiling_dump_{currentdatetime}` | | | profiling_start_seconds | | | **Description:** Starts collecting a profiler dump for a specified duration (in seconds) and writes it to the given file path. The profiler dump contains per-frame runtime performance data that can be later analyzed using the *[ProfilerDump](../../api/library/engine/class.profilerdump_cpp.md) class*. Recording automatically stops after the specified number of seconds, or earlier if the *[*stopProfilerDump()*](../../api/library/engine/class.profiler_cpp.md#stopProfilerDump_void)* method or the [profiling_stop](../../code/console/index.md#profiling_stop) command is called. **Arguments:** - *float* **seconds** - The duration, in seconds, for which the profiler should collect data. The profiler will automatically stop recording after this period. - *string* **path** - The file path where the profiler dump will be written. You can specify an absolute path or a path relative to *[profiling_dump_dir](../../code/console/index.md#profiling_dump_dir)*. If the path isn't specified, the profiler dump will be saved to: `profiling_dump_dir/profiling_dump_{currentdatetime}` | | | profiling_start_frames | | | **Description:** Starts collecting a profiler dump for a specified number of frames and writes it to the given file path. The profiler dump contains per-frame runtime performance data that can be later analyzed using the *[ProfilerDump](../../api/library/engine/class.profilerdump_cpp.md) class*. Recording automatically stops after the specified number of frames, or earlier if the *[*stopProfilerDump()*](../../api/library/engine/class.profiler_cpp.md#stopProfilerDump_void)* method or the [profiling_stop](../../code/console/index.md#profiling_stop) command is called. **Arguments:** - *int* **frames** - The number of frames to record the data. The profiler will automatically stop recording after this period. - *string* **path** - The file path where the profiler dump will be written. You can specify an absolute path or a path relative to *[profiling_dump_dir](../../code/console/index.md#profiling_dump_dir)*. If the path isn't specified, the profiler dump will be saved to: `profiling_dump_dir/profiling_dump_{currentdatetime}` | | | profiling_stop | | | **Description:** Stops the currently active profiler dump recording. If a profiler dump is in progress, calling this method finalizes the dump and closes the output file. | | | profiling_status | | | **Description:** - **Command.** Prints the current state of the profiler dump recording process. If a profiler dump is being recorded, the command displays the amount of time or number of frames captured, depending on the recording mode: If no profiler dump is currently being recorded, the command prints a message that profiler dump recording is not active. - Frame-based recording: shows the number of frames left. - Time-based recording: shows the number of seconds left. - Unlimited recording: shows the total number of seconds elapsed since the dump started. | | | profiling_dump_dir | Config file: [*.global](../../code/configuration_file_cpp.md#global) | | **Description:** - **Variable.** Prints a current path used to store profiling dumps. - **Command.** Specifies the directory where profiler dump files (`*.profiler_dump`) are stored when no explicit file path is provided in the profiler start commands or API calls. | **Arguments:** `Path` to the directory used for storing profiling dumps: Default values: - *profiling_dump* (in the current project's *data* directory) | ## VR Settings | vr_info | | |---|---| | **Description:** - **Command.** Prints the information on the current VR API and the connected VR devices � HMD, controllers, and others. For the controllers, it also displays the battery level (if available). | | | vr_debug_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current debug mode for VR API. - **Command.** � Sets the debug mode for VR API. > **Notice:** When the debug mode is enabled, a severe slowdown may occur. | **Arguments:** **0** - release VR context (no debug) (by default) **1** - debug VR context **2** - debug VR context with break on error (only on debug binaries) | | vr_reset_zero_pose | | | **Description:** - **Command.** Sets the zero pose to the current tracker position. | | | vr_show_profiler | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** display mode of the profiler overlay rendered inside the HMD view, one of the *SHOW_PROFILER_** values (disabled, basic, or advanced). Disabled by default. | | | vr_show_profiler_memory | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the memory info panel of the VR profiler overlay is displayed. Effective only when the **[getShowProfiler_int](#getShowProfiler_int)** property is not set to disabled. Enabled by default. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vr_show_profiler_misc | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the miscellaneous info panel of the VR profiler overlay is displayed. Effective only when the **[getShowProfiler_int](#getShowProfiler_int)** property is not set to disabled. Enabled by default. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vr_show_profiler_performance | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the performance info panel of the VR profiler overlay is displayed. Effective only when the **[getShowProfiler_int](#getShowProfiler_int)** property is not set to disabled. Enabled by default. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vr_profiler_background_alpha | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current opacity of the VR profiler overlay background. The value is in the [0.0; 1.0] range, 0.8 by default. Effective only when the **[getShowProfiler_int](#getShowProfiler_int)** property is not set to disabled. - **Command.** � Sets the opacity of the VR profiler overlay background. The value is in the [0.0; 1.0] range, 0.8 by default. Effective only when the **[getShowProfiler_int](#getShowProfiler_int)** property is not set to disabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.8f** - by default | | vr_profiler_position | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** position of the VR profiler overlay within the HMD view, one of the *PROFILER_POSITION_** values aligned with the numeric keypad layout. The default is the center of the view. Effective only when the **[getShowProfiler_int](#getShowProfiler_int)** property is not set to disabled. | | | vr_render_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering into the head-mounted display is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_render_while_hmd_idle | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering is enabled while HMD is not worn. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vr_peripheral_rendering_mode_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the peripheral rendering mode is enabled. In this mode, the HMD has two context (peripheral) and two focus viewports. You can disable two additional viewports to improve performance. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_peripheral_rendering_border_width | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current width of the transition border between foveal (focus) and context rendering zones. A value of 1.0 means the entire viewport has a wide, smooth transition. A very small value (close to epsilon) means the transition will be extremely narrow and almost invisible. - **Command.** � Sets the width of the transition border between foveal (focus) and context rendering zones. A value of 1.0 means the entire viewport has a wide, smooth transition. A very small value (close to epsilon) means the transition will be extremely narrow and almost invisible. | **Arguments:** **[eps; 1.0f]** - available range **0.2f** - by default | | vr_peripheral_rendering_debug_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if debug visualization for peripheral rendering is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_peripheral_rendering_debug_gaze_override_coord | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** gaze position used when the debug override mode is set to *[COORD](#PERIPHERAL_RENDERING_DEBUG_GAZE_OVERRIDE_MODE_COORD)*, as normalized UV coordinates in texture space. The value (0, 0) is the top-left corner, (0.5, 0.5) is the center (default), (1, 1) is the bottom-right corner. | | | vr_peripheral_rendering_debug_gaze_override_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** debug override mode for the gaze position used by peripheral (foveated) rendering, one of the *PERIPHERAL_RENDERING_DEBUG_GAZE_OVERRIDE_MODE_** values. Disabled by default. | | | vr_peripheral_rendering_focus_deadzone | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current angular deadzone between the focus and context viewport transition. > **Notice:** Available for OpenXR only. - **Command.** � Sets the angular deadzone between the focus and context viewport transition. > **Notice:** Available for OpenXR only. | **Arguments:** **[0.0f; 1.0f]** - available range **0.15f** - by default | | vr_peripheral_rendering_focus_scale | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current scale factor controlling the size of the foveal (focus) area. - **Command.** � Sets the scale factor controlling the size of the foveal (focus) area. | **Arguments:** **[0; 1]** - available range. **(0.5f, 0.2f)** - default value. | | vr_peripheral_rendering_fov_scale | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current scale factor applied to the field of view used for focus viewports. - **Command.** � Sets the scale factor applied to the field of view used for focus viewports. | **Arguments:** **[0; 1]** - available range. **(0.3f, 0.3f)** - default value. | | vr_service_init_timeout | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current VR initialization timeout in number of attempts. The engine attempts to run VR Service and has to wait for its initialization. - **Command.** � Sets the VR initialization timeout in number of attempts. The engine attempts to run VR Service and has to wait for its initialization. | **Arguments:** **[0; 200]** - available range **60** - by default | | vr_mirror_crop | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current crop factor defining how the VR image is zoomed when mirrored to the target window. The value 1.0 means no crop, 2.0 means 2x zoom (default), and 5.0 is the maximum. - **Command.** � Sets the crop factor defining how the VR image is zoomed when mirrored to the target window. The value 1.0 means no crop, 2.0 means 2x zoom (default), and 5.0 is the maximum. | **Arguments:** **[1.0f; 5.0f]** - available range **2.0f** - by default | | vr_mirror_crop_offset | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** offset of the cropped VR mirror image within the target window, as normalized coordinates. The value (0, 0) corresponds to the top-left corner, (0.5, 0.5) means no offset (default), (1, 1) is the bottom-right corner. | | | vr_mirror_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current mirror mode that defines how the mirrored image (i.e. VR image) will be displayed in the target window. - **Command.** � Sets the mirror mode that defines how the mirrored image (i.e. VR image) will be displayed in the target window. | **Arguments:** **0** - black screen (no image is displayed). **1** - image rendered for the left eye. **2** - image rendered for the right eye. **3** - stereo image (both the left and right eyes). (by default) | | vr_window_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current window mode that defines which window will display the mirrored image (i.e. VR image). - **Command.** � Sets the window mode that defines which window will display the mirrored image (i.e. VR image). | **Arguments:** **0** - mirroring is disabled. **1** - main window displays the mirrored image. (by default) | | vr_tracking_space | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current zero pose of the tracking origin. - **Command.** � Sets the zero pose of the tracking origin. | **Arguments:** **0** - poses are provided relative to the Local (Seated or Stationary in OpenVR) Tracking Space. The origin is based on the user's position at startup (or after reset). Suited for sitting/simulator experiences (e.g. cockpit VR), where the player is already placed at the desired position. **1** - poses are provided relative to the Absolute (Standing in OpenVR) Tracking Space. The origin is fixed to the physical floor level (established by the tracking system, e.g. Base Stations or HMD SLAM Tracking). Suited for standing/room-scale experiences where the player is placed on the floor and the camera height comes from the HMD offset. (by default) | | vr_head_tracking_position_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the head position is locked. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vr_head_tracking_rotation_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the head rotation is locked. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vr_motion_prediction | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if motion prediction is enabled. When enabled, the engine submits the velocity value from the GBuffer to the VR compositor. Check [hasFeatureMotionPrediction()](#hasFeatureMotionPrediction_int) to verify availability. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_motion_prediction_velocity_precision | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current factor of velocity scale before packing a floating point value into a 2x8 bit unsigned integer (uint). Requires [motion prediction support](#hasFeatureMotionPrediction_int). - **Command.** � Sets the factor of velocity scale before packing a floating point value into a 2x8 bit unsigned integer (uint). Requires [motion prediction support](#hasFeatureMotionPrediction_int). | **Arguments:** **[eps; inf]** - available range **32.0f** - by default | | vr_motion_prediction_velocity_time_delta | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current factor for optimizing between fast and slow-moving objects. A smaller number works better for fast-moving objects, and vice versa. Requires [motion prediction support](#hasFeatureMotionPrediction_int). - **Command.** � Sets the factor for optimizing between fast and slow-moving objects. A smaller number works better for fast-moving objects, and vice versa. Requires [motion prediction support](#hasFeatureMotionPrediction_int). | **Arguments:** **[eps; inf]** - available range **1.0f / 60.0f** - by default | | vr_emulation_mirror_crop | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current crop factor defining how the image is zoomed in the target window when running in VR emulation. The value 1.0 means no crop (default), and 5.0 is the maximum. Used instead of the **[getMirrorCrop_float](#getMirrorCrop_float)** property when not rendering to an HMD. - **Command.** � Sets the crop factor defining how the image is zoomed in the target window when running in VR emulation. The value 1.0 means no crop (default), and 5.0 is the maximum. Used instead of the **[getMirrorCrop_float](#getMirrorCrop_float)** property when not rendering to an HMD. | **Arguments:** **[1.0f; 5.0f]** - available range **1.0f** - by default | | vr_emulation_mirror_crop_offset | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** offset of the cropped mirror image within the target window when running in VR emulation, as normalized coordinates. The value (0, 0) corresponds to the top-left corner, (0.5, 0.5) means no offset (default), (1, 1) is the bottom-right corner. Used instead of the **[getMirrorCropOffset_vec2](#getMirrorCropOffset_vec2)** property when not rendering to an HMD. | | | vr_emulation_mirror_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** mirror mode used when running in VR emulation (without rendering to an HMD), one of the *MIRROR_MODE_** values: black screen, left eye, right eye, or stereo (default). | | | vr_foveated_rendering_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if foveated rendering is enabled. Foveated rendering uses eye tracking to improve performance by reducing the image quality in peripheral areas where the user is not looking, allowing applications to render fewer pixels. Check [hasFeatureFoveatedRendering()](#hasFeatureFoveatedRendering_int) to verify availability. | **Arguments:** **0** - disabled **1** - enabled (by default) | ## Mixed Reality Settings | vr_mixed_reality_apply_settings | | |---|---| | **Description:** Updates the mixed reality settings to the current settings. | | | vr_mixed_reality_chroma_key_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if chroma keying is enabled. [VST capturing](#isVideoEnabled_int) from HMD cameras must be enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_depth_test_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if depth buffer submission is enabled. [VST capturing](#isVideoEnabled_int) from HMD cameras must be enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_alpha_blend_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if alpha blending is enabled. This option is used for blending VR and AR images using the alpha channel. [VST capturing](#isVideoEnabled_int) from HMD cameras must be enabled and the [screen precision](../../api/library/rendering/class.render_cpp.md#isScreenPrecision_int) must be 1. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_video_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the video signal from the real-world view from the front-facing HMD-mounted cameras is enabled. The real-world view is used for combining virtual and real-world elements to create an immersive experience in mixed reality. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_depth_test_range_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the depth test range usage is enabled. Use the [depth test range](#getDepthTestRange_vec2) (*Depth Test Near Z*, *Depth Test Far Z*) to control the range for which the depth test is evaluated. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_depth_test_range | | | **Description:** - **Variable.** � Prints the current depth test range as a two-component vector (the near and far planes). The [depth test range usage](#isDepthTestRangeEnabled_int) must be enabled. - **Command.** � Sets the depth test range as a two-component vector (the near and far planes). The [depth test range usage](#isDepthTestRangeEnabled_int) must be enabled. | **Arguments:** **vec2(0.0f, 1.0f)** - default value | | vr_mixed_reality_camera_exposure_time | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current exposure time value that is valid for the connected device. - **Command.** � Sets the exposure time value that is valid for the connected device. | **Arguments:** - **1** - exposure time value equal to 91 ms - **2** - exposure time value equal to 125 ms (default) - **3** - exposure time value equal to 250 ms - **4** - exposure time value equal to 500 ms - **5** - exposure time value equal to 1000 ms - **6** - exposure time value equal to 2000 ms - **7** - exposure time value equal to 4000 ms - **8** - exposure time value equal to 8000 ms | | vr_mixed_reality_camera_exposure_time_mode | | | **Description:** - **Variable.** � Prints the current exposure adjustment mode for the camera. - **Command.** � Sets the exposure adjustment mode for the camera. | **Arguments:** **0** - exposure adjustment is disabled **1** - automatic exposure adjustment (by default) **2** - manual exposure adjustment | | vr_mixed_reality_camera_white_balance | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current white balance correction value that is valid for the connected device. - **Command.** � Sets the white balance correction value that is valid for the connected device. | **Arguments:** - **1** - white balance value equal to 2000 K - **2** - white balance value equal to 3000 K - **3** - white balance value equal to 3500 K - **4** - white balance value equal to 4200 K - **5** - white balance value equal to 5000 K - **6** - white balance value equal to 5400 K - **7** - white balance value equal to 6500 K (default) - **8** - white balance value equal to 8000 K - **9** - white balance value equal to 12000 K | | vr_mixed_reality_camera_white_balance_mode | | | **Description:** - **Variable.** � Prints the current white balance adjustment mode for the camera. - **Command.** � Sets the white balance adjustment mode for the camera. | **Arguments:** **0** - white balance adjustment is disabled **1** - automatic white balance adjustment (by default) **2** - manual white balance adjustment | | vr_mixed_reality_camera_iso | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current ISO value for the camera. - **Command.** � Sets the ISO value for the camera. | **Arguments:** - **1** - ISO value equal to 100 - **2** - ISO value equal to 200 - **3** - ISO value equal to 400 - **4** - ISO value equal to 800 (default) - **5** - ISO value equal to 1600 - **6** - ISO value equal to 3200 - **7** - ISO value equal to 6400 | | vr_mixed_reality_camera_iso_mode | | | **Description:** - **Variable.** � Prints the current ISO adjustment mode for the camera. - **Command.** � Sets the ISO adjustment mode for the camera. | **Arguments:** **0** - ISO adjustment is disabled **1** - automatic ISO adjustment (by default) **2** - manual ISO adjustment | | vr_mixed_reality_camera_flicker_compensation | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current flicker compensation value for the camera. - **Command.** � Sets the flicker compensation value for the camera. This is useful when using the HMD indoors with mostly artificial light bulbs, which flicker at the frequency of 50Hz or 60Hz and can cause visual flicker artifacts on the video see through image. The correct setting depends on the underlying power grid's frequency. For example, in most parts of Africa/Asia/Australia/Europe the frequency is 50 Hz and in most parts of North and South America 60 Hz. | **Arguments:** - **1** - flicker compensation value equal to 50 Hz (default). - **2** - flicker compensation value equal to 60 Hz. | | vr_mixed_reality_camera_sharpness | | | **Description:** - **Variable.** � Prints the current sharpness filter power value for the camera. - **Command.** � Sets the sharpness filter power value for the camera. | **Arguments:** **[0; 10]** - available range **0** - by default | | vr_mixed_reality_view_offset | | | **Description:** - **Variable.** � Prints the current eyes [view offset](https://developer.varjo.com/docs/apidocs/_varjo__mr_8h.html#a0aa1772b02020977c3c5b1c974848f75) (where eye camera should be positioned when using Mixed Reality): - **0** for physical eye position - **1** for VST camera position - **Command.** � Sets the eyes [view offset](https://developer.varjo.com/docs/apidocs/_varjo__mr_8h.html#a0aa1772b02020977c3c5b1c974848f75) (where eye camera should be positioned when using Mixed Reality): - **0** for physical eye position - **1** for VST camera position | **Arguments:** **[0.0; 1.0]** - available range **0.0** - by default | | vr_mixed_reality_marker_tracking_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if marker tracking is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_marker_visualizer_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating the marker visualizer is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_blend_masking_mode | | | **Description:** - **Variable.** � Prints the current mode of the *Blend Control Mask* that can be used to extend or restrict the chroma key mask or to control the depth testing against the estimated video depth. - **Command.** � Sets the mode of the *Blend Control Mask* that can be used to extend or restrict the chroma key mask or to control the depth testing against the estimated video depth. | **Arguments:** **0** - Disabled (masking mode is disabled). (by default) **1** - Restrict Video to Mask (show the video pass-through image (VST) in the mask; can be used with chroma key) **2** - Restrict VR to Mask (show VR in the mask; can be used with chroma key) **3** - Restrict VR to Chromakey reduced by Mask (show VR in the mask and chroma elsewhere; requires chroma key) | | vr_mixed_reality_blend_masking_debug_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if blend masking debug visualization is enabled. The [blend masking mode](#getBlendMaskingMode_int) must be enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_mixed_reality_cubemap_mode | | | **Description:** - **Variable.** � Prints the current mode defining the way the AR texture is set for the environment. - **Command.** � Sets the mode defining the way the AR texture is set for the environment. | **Arguments:** **0** - cubemap streaming from AR cameras is disabled. **1** - environment texture substitutes the sky. **2** - the first environment preset defines the way the AR texture is set for the environment. (by default) **3** - the second environment preset defines the way the AR texture is set for the environment. **4** - the third environment preset defines the way the AR texture is set for the environment. | | vr_mixed_reality_cubemap_ggx_quality | | | **Description:** - **Variable.** � Prints the current quality of the generated GGX mips for the AR cubemap. - **Command.** � Sets the quality of the generated GGX mips for the AR cubemap. | **Arguments:** **0** - low **1** - medium (by default) **2** - high **3** - ultra | | vr_mixed_reality_override_color_correction_mode | | | **Description:** - **Variable.** � Prints the current color correction mode for the stream from the AR cameras. - **Command.** � Sets the color correction mode for the stream from the AR cameras. | **Arguments:** **0** - correction is disabled. (by default) **1** - exposure correction for the stream from the AR cameras. **2** - exposure and white balance correction for the stream. | | vr_mixed_reality_camera_vst_reprojection_mode | | | **Description:** - **Variable.** � Prints the current reprojection mode of VST. - **Command.** � Sets the reprojection mode of VST. | **Arguments:** **0** - reprojection of VST is disabled (default). (by default) **1** - automatic reprojection mode of VST (the Depth buffer is used for reprojection) **2** - manual reprojections mode of VST | | vr_mixed_reality_camera_vst_reprojection_distance | | | **Description:** - **Variable.** � Prints the current static distance in meters used to shift the whole image. Is configured only if the [VST reprojection mode](#CameraVSTReprojectionMode) is set to [Manual](#CAMERA_PROPERTY_MODE_MANUAL). - **Command.** � Sets the static distance in meters used to shift the whole image. Is configured only if the [VST reprojection mode](#CameraVSTReprojectionMode) is set to [Manual](#CAMERA_PROPERTY_MODE_MANUAL). | **Arguments:** **[0.0f; 1000.0f]** - available range **0.0f** - by default | ## VR Hand Tracking Settings | vr_hand_tracking_show_basis | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the visualizer for the coordinate axes (basis) of each hand bone is enabled. This option requires the [Hand visualizer](#vr_hand_tracking_visualizer_enabled) to be enabled. ![](../../api/library/vr/ht_command_bone_basis.png) | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_hand_tracking_show_bone_sizes | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the visualizer for the size of each hand bone is enabled. Displays red spheres representing the size (radius) of each bone, providing a visual reference for the physical dimensions of the tracked hand. This option requires the [Hand visualizer](#vr_hand_tracking_visualizer_enabled) to be enabled. ![](../../api/library/vr/ht_command_bone_sizes.png) | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_hand_tracking_show_velocity | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the visualizer for the velocity vectors of each hand bone is enabled. Useful for debugging motion-based interactions like swipes or throws. This option requires the [Hand visualizer](#vr_hand_tracking_visualizer_enabled) to be enabled. ![](../../api/library/vr/ht_command_bone_velocity.png) | **Arguments:** **0** - disabled (by default) **1** - enabled | | vr_hand_tracking_visualizer_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the visualizer for hands is enabled. When set to 1, the engine will draw a simple debug skeleton of the hands, showing bones only. This option requires the [Visualizer](../../code/console/index.md#show_visualizer) to be enabled. ![](../../api/library/vr/ht_command_visualizer.png) | **Arguments:** **0** - disabled (by default) **1** - enabled | ## Video Settings | video_adapter | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints the current the hardware video adapter [ID](../../api/library/engine/class.systeminfo_cpp.md#getGPUID_int_int) to be used for rendering. - **Command.** � Sets the the hardware video adapter [ID](../../api/library/engine/class.systeminfo_cpp.md#getGPUID_int_int) to be used for rendering. The value must be from 0 to [the number of available video adapters](../../api/library/engine/class.systeminfo_cpp.md#getGPUCount_int). To obtain a universal unique identifier (*UUID*), which is persistent across reboots and hardware configuration changes, use `-video_adapter_uuid`. > **Notice:** Available only during the Engine initialization (startup), has no effect at run time. | **Arguments:** **[0; 32]** - available range **0** - by default | | video_debug | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current video debug mode for graphical API. - **Command.** � Sets the video debug mode for graphical API. > **Warning:** Beware of severe slowdown when enabled. > **Notice:** Available only during the Engine initialization (startup), has no effect at run time. | **Arguments:** **0** - release rendering context (no debug) (by default) **1** - debug rendering context **2** - debug rendering context with break on error (only on debug binaries) **3** - GPU side validation (dx12-only, only on debug binaries) | | video_debug_shader | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current status of debug shaders for the application regardless of its binary type (debug or release). - **Command.** � Sets the status of debug shaders 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](https://renderdoc.org/) debugger). | **Arguments:** **0** - disable debug shaders (release shaders are used) (by default) **1** - enable debug shaders | | video_debug_crash_dump | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables generation of GPU crash dump files. The dumps will be saved to `bin/gpu_crash_dumps` inside the project folder. | **Arguments:** **0** - disabled (by default) **1** - enabled | | video_debug_clear_driver_pso_cache | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Bypasses the [GPU Pipeline Cache](../../editor2/shaders_precompile/index.md#cache_type_pso_log) and temporarily clears the [Driver Cache](../../editor2/shaders_precompile/index.md#cache_type_driver) from `%LOCALAPPDATA%` (or `LocalLow` for Intel GPUs) on Engine startup. The driver cache files are restored when the Engine shuts down, so this only affects the current session. Useful for simulating a first-time startup experience - without these caches, PSO creation takes significantly longer, matching what end users experience on their first run. | **Arguments:** **0** - disabled (by default) **1** - enabled | | show_displays | | | **Description:** - **Command.** Prints the information about all available displays. | | | show_display_modes | | | **Description:** - **Command.** Prints the information about all available modes for the specified display. | **Arguments:** Index of the display for which modes are to be displayed (0 - by default). | ### Main Window Resolution and Fullscreen Operations on main window options adjustment (size, fullscreen mode, borders, restart, etc.). | video_offscreen | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables the offscreen mode for the application, making 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. | **Arguments:** **0** - disabled (by default) **1** - enabled | | main_window | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables creating a main window during the application start-up. After starting up the application any window can be created and will work normally. For example, this can be useful in a custom editor or any other application, where there should be no main Engine window. > **Notice:** Available only during the Engine initialization (startup), has no effect at run time. | **Arguments:** **0** - disabled **1** - enabled (by default) | | main_window_size | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current size of the main application window. - **Command.** � Sets the size of the main application window. | **Arguments:** Usage with the argument: *main_window_size **width height*** (1600 x 900 by default) | | main_window_resizable | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables the resizable mode for the main application window (its size can be changed on the fly without restarting the application). | **Arguments:** **0** - disabled **1** - enabled (by default) | | main_window_fullscreen | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current fullscreen mode for the application window. Only one window is available, when the application runs in the fullscreen mode (no other windows or dialogs shall be displayed atop). - **Command.** � Sets the fullscreen mode for the application window. Only one window is available, when the application runs in the fullscreen mode (no other windows or dialogs shall be displayed atop). | **Arguments:** **0** - windowed mode (by default) **1** - full-screen mode | | main_window_fullscreen_display | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current display on which to show the main application window in fullscreen mode. - **Command.** � Sets the display on which to show the main application window in fullscreen mode. | **Arguments:** **0** - **Main** - display set as main in OS settings. (by default) **1** - **Current** - display that currently has focus (where the mouse cursor is). | | main_window_fullscreen_display_mode | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current display mode (resolution and frequency) for the application window to be shown in fullscreen mode. - **Command.** � Sets the display mode (resolution and frequency) for the application window to be shown in fullscreen mode. | **Arguments:** **0** - **Desktop** - use display mode currently selected on the user's computer. (by default) **1** - **Mode by window size** - try to find an appropriate display mode that corresponds to the current window resolution (while looking for the appropriate resolution the Engine tries to keep the current desktop display frequency if possible, otherwise it takes maximum available frequency). > **Notice:** In case such mode does not exist (a corresponding error message is displayed), switch to the **Desktop** mode. | | main_window_auto_restart | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables automatic reopening of the main application window after changing its settings ([fullscreen mode](#main_window_fullscreen), [borders](#main_window_borders), [size](#main_window_size), etc.). Can be disabled, when necessary, to control main window restart manually via the [restart_main_window](#restart_main_window) command. | **Arguments:** **0** - disabled **1** - enabled (by default) | | main_window_borders | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables drawing the borders of the main application window. In some cases it might be necessary to render the window in borderless mode. | **Arguments:** **0** - disabled **1** - enabled (by default) | | restart_main_window | | | **Description:** - **Command.** Reopens the main window applying new settings ([fullscreen mode](#main_window_fullscreen), [borders](#main_window_borders), [size](#main_window_size), etc.). | | ### Graphics Settings Operations on the graphics adjustment. | render_vsync | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | |---|---| | **Description:** - **Variable.** � Prints the current vertical FPS synchronization. - **Command.** � Sets the vertical FPS synchronization. | **Arguments:** **0** - not to synchronize FPS (by default) **1** - synchronize FPS **2** - enable adaptive vertical sync | | video_quadro_sync | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables NVIDIA Quadro Sync feature providing support for synchronization of frame rendering across multiple displays. Enabling this option automatically sets the view to fullscreen, enables [VSYNC](../../api/library/rendering/class.render_cpp.md#VSync) and sets the [MaxFPS](../../api/library/rendering/class.render_cpp.md#MaxFPS) value to 0. | **Arguments:** **0** - disabled (by default) **1** - enabled | | d3d12_vsync_interval | | | **Description:** - **Variable.** � Prints the current value that controls the VSync swap interval for DirectX 12 (e.g., swap buffers every n-th refresh interval of the monitor). - **Command.** � Sets the value that controls the VSync swap interval for DirectX 12 (e.g., swap buffers every n-th refresh interval of the monitor). | **Arguments:** [1; 4] - available range 1 - by default For example, for a 120 Hz monitor: - **120** Hz (no vblank) - **Sync Interval = 1** - **60** Hz (every 2nd vblank) - **Sync Interval = 2** - **40** Hz (every 3rd vblank) - **Sync Interval = 3** - **30** Hz (every 4th vblank) - **Sync Interval = 4** | | d3d12_immediate | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables or disables immediate command submission to the GPU. When disabled, commands are buffered and submitted with a delay of approximately 2-3 frames, allowing the CPU and GPU to operate asynchronously. When enabled, the frame-latency queue is bypassed and commands are submitted without delay, typically used for debugging. **Works for DirectX 12 only**. | **Arguments:** **0** - disabled (by default) **1** - enabled | | vk_frame_pool_gpu_upload | | | **Description:** - **Variable.** � Prints the current - **Variable.** Frame VRAM upload pool (ReBAR) memory limit in MB. - **Command.** � Sets the - **Variable.** Frame VRAM upload pool (ReBAR) memory limit in MB. | **Arguments:** **[0; 16384]** - available range **128** - by default | | vk_frame_pool_upload | | | **Description:** - **Variable.** � Prints the current - **Variable.** Frame upload pool memory limit in MB. - **Command.** � Sets the - **Variable.** Frame upload pool memory limit in MB. | **Arguments:** **[0; 16384]** - available range **128** - by default | | vk_gpu_upload_heap | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � - **Variable.** Enable GPU upload heap (ReBAR) for Vulkan frame pools. | **Arguments:** **0** - disabled **1** - enabled (by default) | | vk_immediate | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables or disables immediate command submission to the GPU. When disabled, commands are buffered and submitted with a delay of approximately 2-3 frames, allowing the CPU and GPU to operate asynchronously. When enabled, the frame-latency queue is bypassed and commands are submitted without delay, typically used for debugging. **Works for Vulkan only**. | **Arguments:** **0** - disabled (by default) **1** - enabled | ## Rendering Settings Operations on the renderer. | textures_reload | |---| | **Description:** - **Command.** Reloads all render textures. | ### Rendering Resources Operations representing information on the rendering resources. | render_budget | | |---|---| | **Description:** - **Variable.** � Prints the current render budget value, in seconds, which limits the number of loaded/created graphics resources during a frame according to loading/creation time. - **Command.** � Sets the render budget value, in seconds, which limits the number of loaded/created graphics resources during a frame according to loading/creation time. | **Arguments:** **[0.0f; inf]** - available range **1/60** - by default | | render_streaming_cache_ram | | | **Description:** - **Variable.** � Prints the current maximum size of RAM available for streaming caches. When set to -1, caches grow freely up to [engine limits](#render_streaming_usage_limit_ram). When limited, caches will grow only up to the defined value. If the limit is too low, not all resources will fit into the cache in time, which may cause streaming to stutter. - **Command.** � Sets the maximum size of RAM available for streaming caches. When set to -1, caches grow freely up to [engine limits](#render_streaming_usage_limit_ram). When limited, caches will grow only up to the defined value. If the limit is too low, not all resources will fit into the cache in time, which may cause streaming to stutter. | **Arguments:** **[-1; inf]** - available range **-1** - by default | | render_streaming_cache_vram | | | **Description:** - **Variable.** � Prints the current maximum size of VRAM available for streaming caches. When set to -1, caches grow freely up to [engine limits](#render_streaming_usage_limit_vram). When limited, caches will grow only up to the defined value. If the limit is too low, not all resources will fit into the cache in time, which may cause streaming to stutter. - **Command.** � Sets the maximum size of VRAM available for streaming caches. When set to -1, caches grow freely up to [engine limits](#render_streaming_usage_limit_vram). When limited, caches will grow only up to the defined value. If the limit is too low, not all resources will fit into the cache in time, which may cause streaming to stutter. | **Arguments:** **[-1; inf]** - available range **-1** - by default | | render_streaming_free_space_ram | | | **Description:** - **Variable.** � Prints the current amount of physical memory that the Engine will always keep free and never allocate for its own use, in Mbytes. - **Command.** � Sets the amount of physical memory that the Engine will always keep free and never allocate for its own use, in Mbytes. | **Arguments:** **[0; INT_MAX]** - available range **1024** - by default | | render_streaming_free_space_vram | | | **Description:** - **Variable.** � Prints the current amount of VRAM that the Engine will always keep free and never allocate for its own use, in Mbytes. - **Command.** � Sets the amount of VRAM that the Engine will always keep free and never allocate for its own use, in Mbytes. | **Arguments:** **[0; INT_MAX]** - available range **512** - by default | | render_streaming_free_space_ram_committed | | | **Description:** - **Variable.** � Prints the current amount of committed memory that the Engine will always keep free and never allocate for its own use, in Mbytes. - **Command.** � Sets the amount of committed memory that the Engine will always keep free and never allocate for its own use, in Mbytes. | **Arguments:** **[0; INT_MAX]** - available range **512** - by default | | render_streaming_usage_limit_ram | | | **Description:** - **Variable.** � Prints the current percentage of the total physical memory (RAM) that the Engine is allowed to use for streaming. - **Command.** � Sets the percentage of the total physical memory (RAM) that the Engine is allowed to use for streaming. If the streaming exceeds the RAM usage limit, the application may become unstable or crash. | **Arguments:** **[10; 100]** - available range **80** - by default | | render_streaming_usage_limit_vram | | | **Description:** - **Variable.** � Prints the current percentage of the committed video memory available for streaming. - **Command.** � Sets the percentage of the committed video memory available for streaming. If the streaming exceeds the VRAM usage limit, it will start using RAM for loading graphic resources. | **Arguments:** **[10; 100]** - available range **80** - by default | | render_streaming_meshes_mode_ram | | | **Description:** - **Variable.** � Prints the current streaming mode for loading meshes to memory (RAM). - **Command.** � Sets the streaming mode for loading meshes to memory (RAM). The following modes are available: - *Async* - asychronous loading of meshes. - *Force* - force-loading of meshes required for the current frame at once. | **Arguments:** **0** - asynchronous streaming (by default) **1** - force-loading of resources | | render_streaming_meshes_mode_vram | | | **Description:** - **Variable.** � Prints the current streaming mode for loading meshes to video memory (VRAM). - **Command.** � Sets the streaming mode for loading meshes to video memory (VRAM). The following modes are available: - *Async* - asynchronous loading of meshes. - *Force* - force-loading of meshes required for the current frame at once. | **Arguments:** **0** - asynchronous streaming (by default) **1** - force-loading of resources | | render_streaming_mesh_cache_ram | | | **Description:** - **Variable.** � Prints the current maximum amount of memory, in megabytes, the streaming system may keep cached in RAM for static meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. - **Command.** � Sets the maximum amount of memory, in megabytes, the streaming system may keep cached in RAM for static meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_mesh_cache_vram | | | **Description:** - **Variable.** � Prints the current maximum amount of memory, in megabytes, the streaming system may keep cached in video memory for static meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. - **Command.** � Sets the maximum amount of memory, in megabytes, the streaming system may keep cached in video memory for static meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_mesh_skinned_cache_ram | | | **Description:** - **Variable.** � Prints the current maximum amount of memory, in megabytes, the streaming system may keep cached in RAM for skinned meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. - **Command.** � Sets the maximum amount of memory, in megabytes, the streaming system may keep cached in RAM for skinned meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_mesh_skinned_cache_vram | | | **Description:** - **Variable.** � Prints the current maximum amount of memory, in megabytes, the streaming system may keep cached in video memory for skinned meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. - **Command.** � Sets the maximum amount of memory, in megabytes, the streaming system may keep cached in video memory for skinned meshes. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_meshes_info | | | **Description:** - **Command.** Prints general information (the number of registered/loaded meshes; memory used) on rendering resources. | | | render_streaming_meshes_list | | | **Description:** - **Command.** Prints the list of loaded meshes and detailed information about the memory used. | | | render_streaming_meshes_reload | | | **Description:** - **Command.** Reloads all loaded meshes. | | | render_streaming_skinned_mesh_info | | | **Description:** - **Command.** Prints the total number of registered and loaded skinned mesh resources, along with their combined RAM and VRAM usage. | | | render_streaming_skinned_mesh_list | | | **Description:** - **Command.** Displays all loaded skinned mesh assets currently present in the world, including each asset's path, RAM usage, and VRAM usage. | | | render_streaming_skinned_mesh_reload | | | **Description:** - **Command.** Reload all skinned meshes. | | | render_streaming_meshes_prefetch_collision | | | **Description:** - **Variable.** � Prints the current mode of asynchronous pre-loading of meshes to memory before they are used. - **Command.** � Sets the mode of asynchronous pre-loading of meshes to memory before they are used. Pre-loading is available only for meshes, which have at least one surface with the *Collision* flag set. There are 2 modes of loading such meshes to RAM: This method should be used when the *Async* streaming mode for meshes is set. - *Disable* - loading is disabled. - *Radius* - meshes within the prefetch radius are loaded. | **Arguments:** **0** - disable (by default) **1** - radius | | render_streaming_meshes_prefetch_intersection | | | **Description:** - **Variable.** � Prints the current mode of asynchronous pre-loading of meshes into memory before they are used. - **Command.** � Sets the mode of asynchronous pre-loading of meshes into memory before they are used. Pre-loading is available only for meshes, which have at least one surface with the *Intersection* flag set. There are 2 modes of loading such meshes to RAM: This method should be used when the *Async* streaming mode for meshes is set. - *Disable* - loading is disabled. - *Radius* - all meshes within the prefetch radius are loaded. | **Arguments:** **0** - disable (by default) **1** - radius | | render_streaming_meshes_prefetch_radius | | | **Description:** - **Variable.** � Prints the current radius within which meshes are pre-loaded into memory. - **Command.** � Sets the radius within which meshes are pre-loaded into memory. The value should exceed the physics radius (for collisions) and/or the radius within which intersections are calculated. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_streaming_particles_memory_limit | | | **Description:** - **Variable.** � Prints the current cache memory limit for vertices of particle systems, in percentage of the total GPU memory. - **Command.** � Sets the cache memory limit for vertices of particle systems, in percentage of the total GPU memory. > **Notice:** Setting a too low limit for a huge number of particle systems in the scene may lead to rendering only some of them. Works only with the **Vulkan** graphics API. | **Arguments:** **[0; 100]** - available range **3** - by default | | render_streaming_textures_mode | | | **Description:** - **Variable.** � Prints the current streaming mode for textures. - **Command.** � Sets the streaming mode for textures. The following modes are available: - *Async* - asynchronous loading of textures. - *Force* - force-loading of textures required for each frame at ones. | **Arguments:** **0** - asynchronous streaming (by default) **1** - force-loading of resources | | render_streaming_textures_mipmaps | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether texture mipmap loading is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_streaming_textures_mipmaps_density | | | **Description:** - **Variable.** � Prints the current density of mipmaps relative to the screen resolution. - **Command.** � Sets the density of mipmaps relative to the screen resolution. This value helps to define which mipmap should be loaded at the current moment. You can specify different values for different quality presets. | **Arguments:** **[0.0f; 1000000.0f]** - available range **2.0f** - by default | | render_streaming_texture_cache_vram | | | **Description:** - **Variable.** � Prints the current maximum amount of memory, in megabytes, the streaming system may keep cached in video memory for textures. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. - **Command.** � Sets the maximum amount of memory, in megabytes, the streaming system may keep cached in video memory for textures. The value of -1 (default) removes the individual limit, leaving the memory use governed by the common streaming budget. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_textures_info | | | **Description:** - **Command.** Prints general information (the number of registered/loaded textures; memory used) on rendering textures. | | | render_streaming_textures_list | | | **Description:** - **Command.** Prints the list of loaded textures and detailed information about the memory used,texture format, used compression, if any, and texture dimensions. | | | render_streaming_textures_reload | | | **Description:** - **Command.** Reloads all render manager's textures. | | | render_streaming_vram_budget | | | **Description:** - **Variable.** � Prints the current mode for determining the amount of available VRAM. - **Command.** � Sets the mode for determining the amount of available VRAM. The following modes are available: - *System* - the available VRAM size is obtained from the operating system. - *Driver* - the VRAM available for the application is determined by the video driver. - *Full GPU Memory* - all VRAM is available for the application. | **Arguments:** **0** - System **1** - Driver (by default) **2** - Full GPU Memory | | render_streaming_committed_memory_overcommit | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the Engine enforces internal limits on committed memory usage. > **Warning:** With overcommit enabled, crashes may occur if: > > > - the system has no page file > - there is insufficient free disk space on the drive where the page file is located. > > > If system committed memory is fully exhausted, this may affect not only the Engine, but also **other running applications**. - When **disabled**, the Engine respects the **Free Space Committed RAM** setting and will not allocate more committed memory than the configured limit allows. In this mode, the amount of physical RAM and VRAM available to the Engine is effectively reduced to the portion of committed memory accessible within this limit. - When **enabled** (default), the Engine ignores the **Free Space Committed RAM** restriction and can use **all available committed memory** provided by the system. This may improve streaming performance, especially under high memory pressure (for example, when browsers or other background applications are running, or after long system uptime), but it also increases the risk of instability if the system runs out of virtual memory. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_streaming_vram_overcommit | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether VRAM limits (both the usage limit and free space) are applied. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_streaming_animations_mode | | | **Description:** - **Variable.** � Prints the current streaming mode for skinned mesh animations. - **Command.** � Sets the streaming mode for skinned mesh animations. The following modes are available: - *Async* - asynchronous loading of animations. - *Force* - force-loading of animations required for the current frame at once. | **Arguments:** **0** - asynchronous streaming **1** - force-loading of resources (by default) | | render_streaming_animations_life_time | | | **Description:** - **Variable.** � Prints the current lifetime of the RAM cache used for animation streaming, in frames. - **Command.** � Sets the lifetime of the RAM cache used for animation streaming, in frames. When an animation is no longer used, it remains in the cache for this number of frames before being unloaded, so that it can be reused without reloading. The default value of -1 keeps animations in memory permanently - they are never unloaded. Values below 6 are clamped to 6 frames. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_animation_cache_ram | | | **Description:** - **Variable.** � Prints the current hard limit on the amount of RAM, in megabytes, used by the animation streaming cache. - **Command.** � Sets the hard limit on the amount of RAM, in megabytes, used by the animation streaming cache. The cache stores currently unused but potentially reusable animations to reduce loading times. The default value of -1 means the cache size is not limited. | **Arguments:** **[-1; INT_MAX]** - available range **-1** - by default | | render_streaming_animations_info | | | **Description:** - **Command.** Prints general information on streaming animations: the total number of registered animation resources, the number of currently loaded animations and the RAM they use, and the number of held animations (kept in memory and never unloaded) together with the RAM they use. | | | render_streaming_animations_list | | | **Description:** - **Command.** Prints the list of streaming animations. For each animation, its file path, the amount of RAM it uses (or not loaded if it is not currently in memory), and whether it is held are displayed. | | | render_streaming_animations_reload | | | **Description:** - **Command.** Unloads all currently unused animations from RAM. Held animations and animations still in use are not affected. Unloaded animations are streamed in again on the next request. | | | render_streaming_igpu_vram_mode | | | **Description:** - **Variable.** � Prints the current mode that determines how the engine calculates the available VRAM budget for integrated GPUs (iGPU) that share system RAM instead of having dedicated video memory. - **Command.** � Sets the mode that determines how the engine calculates the available VRAM budget for integrated GPUs (iGPU) that share system RAM instead of having dedicated video memory. | **Arguments:** **0** - system (by default) **1** - custom size **2** - total memory balance | | render_streaming_igpu_vram_size | | | **Description:** - **Variable.** � Prints the current custom VRAM size (in MB) to be used as the VRAM budget for integrated GPUs. Applicable when [StreamingIGpuVRAMMode](#StreamingIGpuVRAMMode) is set to [SIZE](#STREAMING_IGPU_VRAM_MODE_SIZE). - **Command.** � Sets the custom VRAM size (in MB) to be used as the VRAM budget for integrated GPUs. Applicable when [StreamingIGpuVRAMMode](#StreamingIGpuVRAMMode) is set to [SIZE](#STREAMING_IGPU_VRAM_MODE_SIZE). | **Arguments:** **[512; 32768]** - available range **4096** - by default | | render_streaming_igpu_vram_balance | | | **Description:** - **Variable.** � Prints the current percentage of total system RAM to be used as the VRAM budget for integrated GPUs. Applicable when [StreamingIGpuVRAMMode](#StreamingIGpuVRAMMode) is set to [BALANCE](#STREAMING_IGPU_VRAM_MODE_BALANCE). - **Command.** � Sets the percentage of total system RAM to be used as the VRAM budget for integrated GPUs. Applicable when [StreamingIGpuVRAMMode](#StreamingIGpuVRAMMode) is set to [BALANCE](#STREAMING_IGPU_VRAM_MODE_BALANCE). | **Arguments:** **[10; 80]** - available range **40** - by default | ### Rendering Buffers #### Rendering Buffer Info Operations representing information on the rendering buffers. | render_info | |---| | **Description:** - **Command.** Print general information on render buffers: - Renderer - GPU and available video memory - Per-type information on buffers created by the renderer, their number, and used space - Total - how much video memory is used in whole | | render_list | | **Description:** - **Command.** Print the detailed list of render buffers, with texture size, format and used space. | #### Rendering Buffer Debugging Operations on the rendering buffer debugging. | render_show_textures | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints the current display mode for texture buffers used by the renderer. - **Command.** � Sets the display mode for texture buffers used by the renderer. The number of displayed buffers depends on the number of buffers in a row specified by the corresponding command*[render_show_textures_number](#render_show_textures_number)*. | **Arguments:** **0** - all buffers are hidden (by default) **1** - show render textures (compact) **2** - show render textures (full) | | render_screen_precision | | | **Description:** - **Variable.** � Prints the current value indicating the current screen precision. - **Command.** � Sets the value indicating the current screen precision. This parameter determines the texture format used for screen HDR buffers. | **Arguments:** **0** - RG11B10F **1** - RGBA16F (by default) | | render_show_textures_number | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current number of buffers in a row and column displayed in the full view mode*[render_show_textures](#render_show_textures)*. - **Command.** � Sets the number of buffers in a row and column displayed in the full view mode*[render_show_textures](#render_show_textures)*. Textures are displayed in the following manner, depending on the set value: - **1** - a single texture per screen - **2** - 2x2 textures per screen - **3** - 3x3 textures per screen - ... etc. | **Arguments:** **[0; 16]** - available range **7** - by default | | render_show_textures_offset | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints the current number of the buffer to start displaying from in the full view mode*[render_show_textures](#render_show_textures)*. - **Command.** � Sets the number of the buffer to start displaying from in the full view mode*[render_show_textures](#render_show_textures)*. | **Arguments:** **[0; 256]** - available range **0** - by default | ### Rendering Passes Operations on [rendering passes](../../principles/render/sequence/index.md). | render_debug | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether debug materials (the *debug_materials* material) are rendered. Debug materials can be used for debugging of image generation stages. For example, you can render only SSR, or only cubemaps and so on. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_depth_pre_pass | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if depth pre-pass rendering is enabled. When enabled, an additional depth buffer rendering pass is performed in the beginning of the rendering sequence. > **Notice:** This option can be used to gain performance for well optimized scenes using LODs and having a low-to-medium number of triangles in case of GPU bottlenecks. In other cases (heavy CAD models, large number of triangles and CPU bottlenecks) it may reduce performance, so it is recommended to use [profiling tools](../../tools/profiling/index.md) to make sure that a positive effect is obtained. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_scissors | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if scissor rectangles are displayed. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_ambient | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the ambient pass buffer is displayed. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_alpha_test | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent objects using alpha test. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_depth_pre_pass | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces that use depth pre-pass rendering. This includes surfaces with Alpha Test transparency and opaque surfaces with Force Depth Pre-Pass option enabled in the material. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent objects. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_gbuffer | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to render in the deferred pass (write to GBuffer). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_ambient | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from ambient sources. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_environment_probe | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from Environment Probes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_voxel_probe | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from Voxel Probes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_planar_probe | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from Planar Probes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_light_omni | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from Omni lights. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_light_proj | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from Projected lights. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_transparent_lighting_light_world | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for transparent (blend) surfaces whose material is configured to receive lighting from World light (sun). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_clouds_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of clouds is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_lights_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of lights is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of water is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_screen_space_effects | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of screen-space effects is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_transparent_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the transparent pass is rendered. > **Notice:** This option takes effect only when the forward rendering pass is used for transparent objects rendering. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_transparent_deferred | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the deferred pass for transparent objects is enabled. > **Notice:** This option takes effect only when the forward rendering pass is used for transparent objects rendering. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_transparent_multiple_env_probes | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the transparent [multiple environment probes](../../principles/render/sequence/index.md#transparent_multiple_env_probes) pass is rendered. > **Notice:** This method takes effect only when the forward rendering pass is used for transparent objects rendering. | **Arguments:** **0** - disabled **1** - enabled (by default) | ### Meshes Operations on mesh rendering. | render_alpha_fade | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [alpha-blend fading](../../principles/world_management/index.md#fading) (dithering) is enabled for objects. When the feature is enabled, objects LODs are smoothly blended into each other over a [fade distance](../../principles/world_management/index.md#fading). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_show_dynamic | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for dynamic objects. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_mesh_dynamics | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for dynamic meshes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_mesh_statics | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for static meshes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | mesh_procedural_path | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** Prints a current path used to store temporary procedural mesh files. - **Command.** Specifies the directory for storing temporary procedural mesh files when *[PROCEDURAL_MODE_FILE](../../api/library/objects/class.objectmeshstatic_cpp.md#PROCEDURAL_MODE)* is used. | **Arguments:** `Path` to the directory used for storing temporary procedural mesh files: Default values: - `default.boot`: *data/.unigine_mesh_procedural* - `editor.boot`: *[Cache Directory](../../editor2/settings/hotkeys/index.md#cache_directory)/UNIGINE_Editor_Procedural_Mesh* | | mesh_procedural_read_only | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables read-only mode for procedural file access. When set to 1, the engine does not write procedural mesh data to disk. Instead all generated meshes are stored and managed entirely in **RAM**, as if *[PROCEDURAL_MODE_BLOB](../../api/library/objects/class.objectmeshstatic_cpp.md#PROCEDURAL_MODE)* was active. This helps avoid disk I/O, but procedural meshes will be lost on application exit. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Tessellation Operations on mesh tessellation. | render_tessellation_density_multiplier | | |---|---| | **Description:** - **Variable.** � Prints the current global [Density](../../content/materials/library/mesh_base/index.md#tessellation_density) multiplier for the adaptive hardware-accelerated tessellation. - **Command.** � Sets the global [Density](../../content/materials/library/mesh_base/index.md#tessellation_density) multiplier for the adaptive hardware-accelerated tessellation. *Higher* values produce *denser* meshes. | **Arguments:** **[0.0f; 10.0f]** - available range **1.0f** - by default | | render_tessellation_distance_multiplier | | | **Description:** - **Variable.** � Prints the current global multiplier for all [distance](../../content/materials/library/mesh_base/index.md#tessellation_distance_falloff_near) parameters of the adaptive hardware-accelerated tessellation used for distance-dependent optimization. - **Command.** � Sets the global multiplier for all [distance](../../content/materials/library/mesh_base/index.md#tessellation_distance_falloff_near) parameters of the adaptive hardware-accelerated tessellation used for distance-dependent optimization. *Higher* values make tessellation visible at longer distances from the camera (consuming more resources). | **Arguments:** **[0.0f; 10.0f]** - available range **1.0f** - by default | | render_tessellation_shadow_density_multiplier | | | **Description:** - **Variable.** � Prints the current global [Shadow Density](../../content/materials/library/mesh_base/index.md#tessellation_density_shadow) multiplier for the Tessellated Displacement effect. - **Command.** � Sets the global [Shadow Density](../../content/materials/library/mesh_base/index.md#tessellation_density_shadow) multiplier for the Tessellated Displacement effect. *Higher* values produce more detailed shadows. You can make shadows from tessellated meshes simpler to save performance. | **Arguments:** **[0.01f; 10.0f]** - available range **1.0f** - by default | ### Decals Operations on decal rendering. | render_decals | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of decals is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | ### Fields Operations on field rendering. | render_field_height_resolution | | |---|---| | **Description:** - **Variable.** � Prints the current resolution of the texture into which all textures set for all *[FieldHeight](../../api/library/fields/class.fieldheight_cpp.md)* objects are rendered. - **Command.** � Sets the resolution of the texture into which all textures set for all *[FieldHeight](../../api/library/fields/class.fieldheight_cpp.md)* objects are rendered. > **Notice:** Increased resolution significantly affects performance. | **Arguments:** **0** - 128 x 128 **1** - 256 x 256 **2** - 512 x 512 (by default) **3** - 1024 x 1024 **4** - 2048 x 2048 **5** - 4096 x 4096 **6** - 8192 x 8192 | | render_field_precision | | | **Description:** - **Variable.** � Prints the current value indicating the precision of textures used for field objects. - **Command.** � Sets the value indicating the precision of textures used for field objects. Either of the following: - 16-bit precision R16 texture - 32-bit precision R32F texture | **Arguments:** **0** - 16 bit (by default) **1** - 32 bit | | render_field_shoreline_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the texture into which all textures set for all *[FieldShoreline](../../api/library/fields/class.fieldshoreline_cpp.md)* objects are rendered. - **Command.** � Sets the resolution of the texture into which all textures set for all *[FieldShoreline](../../api/library/fields/class.fieldshoreline_cpp.md)* objects are rendered. > **Notice:** Increased resolution significantly affects performance. | **Arguments:** **0** - 128x128 (by default) **1** - 256x256 **2** - 512x512 **3** - 1024x1024 **4** - 2048x2048 **5** - 4096x4096 **6** - 8192x8192 | ### Textures Operations on texture rendering. | render_textures_quality | | |---|---| | **Description:** - **Variable.** � Prints the current resolution of textures. - **Command.** � Sets the resolution of textures. | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality The default value is **(2)** | | render_textures_max_resolution | | | **Description:** - **Variable.** � Prints the current maximum resolution of all textures. - **Command.** � Sets the maximum resolution of all textures. the engine doesn't compress existing textures: it uses specified mipmaps of `*.dds` textures. | **Arguments:** **0** - 128x128 **1** - 256x256 **2** - 512x512 **3** - 1024x1024 **4** - 2048x2048 **5** - 4096x4096 **6** - 8192x8192 (by default) **7** - 16384x16384 | | render_textures_min_resolution | | | **Description:** - **Variable.** � Prints the current minimum resolution of all textures. - **Command.** � Sets the minimum resolution of all textures. The Engine doesn't compress existing textures: it uses specified mip maps of `*.dds` textures. | **Arguments:** **0** - 128x128 (by default) **1** - 256x256 **2** - 512x512 **3** - 1024x1024 **4** - 2048x2048 **5** - 4096x4096 **6** - 8192x8192 **7** - 16384x16384 | | render_textures_filter | | | **Description:** - **Variable.** � Prints the current texture filtering mode. - **Command.** � Sets the texture filtering mode. | **Arguments:** **0** - Bilinear **1** - Trilinear (by default) | | render_textures_anisotropy | | | **Description:** - **Variable.** � Prints the current anisotropy level for textures (degree of anisotropic filtering). - **Command.** � Sets the anisotropy level for textures (degree of anisotropic filtering). | **Arguments:** **0** - level 1 **1** - level 2 **2** - level 4 **3** - level 8 (by default) **4** - level 16 | ### Shaders Operations on shaders. | render_defines | | |---|---| | **Description:** - **Command.** Print the macros list related to the renderer (defines to make corresponding resources available in shaders). | | | shaders_create_cache_async | | | **Description:** - **Command.** Create shader cache for all loaded materials. | | | shaders_create_cache_force | | | **Description:** - **Command.** Create shader cache for all loaded materials. | | | shaders_create_from_cache | | | **Description:** - **Command.** Creates render material variants and then creates shaders for all loaded materials using only the existing shader cache. Shader variants whose bytecode is already stored in the cache are loaded to RAM; uncached variants are skipped (no compilation is performed). | | | shader_cache_immediate_flush | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Controls how the Engine works with the [Shader Bytecode Cache](../../editor2/shaders_precompile/index.md#cache_type_shader) file. When enabled (default), the file stays on disk and each newly compiled shader is written to it immediately. When disabled, the **raw cache file** is loaded into a RAM buffer at startup and all I/O goes through this buffer, which is faster for bulk operations like shader cache generation. The buffer is flushed to disk on shutdown. | **Arguments:** **0** - disabled **1** - enabled (by default) | #### Shader Compilation Operations on shader compilation. | render_shaders_compile_mode | | |---|---| | **Description:** - **Variable.** � Prints the current compilation mode for shaders that are used in the loaded world. - **Command.** � Sets the compilation mode for shaders that are used in the loaded world. The following modes are available: > **Notice:** This setting does not affect post-processing shaders, lightmap data shaders, and materials with forced compilation - these are always compiled synchronously regardless of this setting. - *Async* - shaders are compiled in a background thread. Objects whose shaders are not yet ready are not rendered (pop-in effect). - *Force* - shaders are compiled synchronously on the main thread. The application freezes until the shader is ready, but objects are rendered immediately. | **Arguments:** **0** - Asynchronous compilation. Objects whose shaders are not yet ready are not rendered (pop-in). (by default) **1** - Forced synchronous compilation. The application freezes until the shader is ready. | | shader_log_compilation | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables logging of shaders for which bytecode is being compiled. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Effects and Postprocesses Operations on the effects and postprocesses. | render_animation_leaf | | |---|---| | **Description:** - **Variable.** � Prints the current global scale for rotation angle of vegetation leaves. - **Command.** � Sets the global scale for rotation angle of vegetation leaves. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_animation_scale | | | **Description:** - **Variable.** � Prints the current global scale for rotation speed of vegetation leaves. - **Command.** � Sets the global scale for rotation speed of vegetation leaves. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_animation_stem | | | **Description:** - **Variable.** � Prints the current global scale for movement amplitude of vegetation stems. - **Command.** � Sets the global scale for movement amplitude of vegetation stems. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_animation_wind | | | **Description:** - **Variable.** � Prints the current direction of wind for all vegetation (grass and trees). - **Command.** � Sets the direction of wind for all vegetation (grass and trees). It is a multiplier for the stem offset (in grass, stem and leaves materials). | **Arguments:** **(0.0f, 0.0f, 0.0f)** - default value | | render_auxiliary | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if auxiliary render buffer is used. The buffer should be enabled for render and post post-processes to work. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_bent_normal | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if ray-traced bent normals calculation is enabled. The use of SSRTGI for bent normals allows for smooth ambient lighting. > **Notice:** Ray-traced bent normals calculation available only when the SSRTGI technique*[render_ssrtgi_preset](#render_ssrtgi_preset)* is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_bent_normal_fix_overlit_areas | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if correction of overlit areas for bent normals calculation is enabled. > **Notice:** - This option may significantly affect performance, so disable it when it's not necessary. > - Ray-traced bent normals calculation is available only when the SSRTGI technique*[render_ssrtgi_preset](#render_ssrtgi_preset)* is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_bent_normal_threshold | | | **Description:** - **Variable.** � Prints the current threshold value for the ray-traced bent normals calculation. - **Command.** � Sets the threshold value for the ray-traced bent normals calculation. > **Notice:** Ray-traced bent normals calculation is available only when the SSRTGI technique*[render_ssrtgi_preset](#render_ssrtgi_preset)* is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_bloom | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the Bloom effect is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_bloom_passes | | | **Description:** - **Variable.** � Prints the current number of passes for the bloom effect. - **Command.** � Sets the number of passes for the bloom effect. During the pass a Bloom texture is generating. Up to 8 Bloom textures can be generated: each texture has lower resolution (original size, original size /2, original size /4, so forth) with Bloom effect. After that, all these Bloom textures with the different resolution form the final Bloom texture. > **Notice:** The higher the value, the smoother the effect is. However, this option significantly affects performance. | **Arguments:** **[2; 8]** - available range **6** - by default | | render_bloom_power | | | **Description:** - **Variable.** � Prints the current power of the Bloom effect. - **Command.** � Sets the power of the Bloom effect. - 0.0f (min) - the Bloom effect is blurred. - 1.0f (max) - the Bloom effect is more contrast. | **Arguments:** **[0.0f; 1.0f]** - available range **0.7f** - by default | | render_bloom_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the Bloom effect. - **Command.** � Sets the resolution of the Bloom effect. | **Arguments:** **0** - quarter **1** - half **2** - full (by default) | | render_bloom_scale | | | **Description:** - **Variable.** � Prints the current scale of the Bloom effect. - **Command.** � Sets the scale of the Bloom effect. | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_border | | | **Description:** - **Variable.** � Prints the current width and height of the image border (in pixels), to be rendered outside the horizontal bounds of the screen to reduce artefacts of post effects. - **Command.** � Sets the width and height of the image border (in pixels), to be rendered outside the horizontal bounds of the screen to reduce artefacts of post effects. > **Notice:** Increasing the width of the border may increase performance costs. | **Arguments:** **(0, 0)** - default value | | render_denoise_preset | | | **Description:** - **Variable.** � Prints the current Denoise preset used at the moment. - **Command.** � Sets the Denoise preset used at the moment. ***Sharpest*** to ***Smoothest*** - intensity of applying the noise reduction temporal filter (smoother settings cause more ghosting, but provide a more credible and smooth effect in static scenes). ***Low*** to ***High*** - quality of blur processing in denoiser (higher values are more performance-consuming). To customize the Denoise effect options at run time, activate the **Custom** preset. | **Arguments:** **0** - Disabled (by default) **1** - Sharpest Low **2** - Sharpest High **3** - Sharp Low **4** - Sharp High **5** - Smooth Low **6** - Smooth High **7** - Smoothest Low **8** - Smoothest High **9** - Custom | | render_denoise_ao_mask_radius | | | **Description:** - **Variable.** � Prints the current radius of the Ambient Occlusion Mask (the Distance buffer) that is used to additionally configure the Denoiser parameters. This parameter affects only the *Environment Probes* with the [Raymarching mode](../../objects/lights/envprobe/index.md#box_projection) enabled. - **Command.** � Sets the radius of the Ambient Occlusion Mask (the Distance buffer) that is used to additionally configure the Denoiser parameters. This parameter affects only the *Environment Probes* with the [Raymarching mode](../../objects/lights/envprobe/index.md#box_projection) enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_denoise_color_clamping_blur_intensity | | | **Description:** - **Variable.** � Prints the current intensity of using the blurred version of the current frame for color clamping. - **Command.** � Sets the intensity of using the blurred version of the current frame for color clamping. | **Arguments:** **[0.0f; 1.0f]** - available range **0.9f** - by default | | render_denoise_color_clamping_blur_intensity_ao | | | **Description:** - **Variable.** � Prints the current intensity of using the blurred version of the current frame for color clamping in the areas where the Ambient Occlusion mask is black. - **Command.** � Sets the intensity of using the blurred version of the current frame for color clamping in the areas where the Ambient Occlusion mask is black. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_denoise_color_clamping_blur_radius | | | **Description:** - **Variable.** � Prints the current blur radius for the current frame. The blurred image is further used in color clamping. This setting helps reducing noise in dark indoor areas. - **Command.** � Sets the blur radius for the current frame. The blurred image is further used in color clamping. This setting helps reducing noise in dark indoor areas. | **Arguments:** **[0.0f; 64.0f]** - available range **8.0f** - by default | | render_denoise_color_clamping_blur_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the Color Clamping Blur buffer. This buffer allows for reducing ghosting artifacts and information lost areas. The *Full* resolution is the slowest one, so we don't recommend using it. - **Command.** � Sets the resolution of the Color Clamping Blur buffer. This buffer allows for reducing ghosting artifacts and information lost areas. The *Full* resolution is the slowest one, so we don't recommend using it. | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(2)** | | render_denoise_hot_pixels_fix_intensity | | | **Description:** - **Variable.** � Prints the current value reducing the intensity of flickering pixels in the screen space. - **Command.** � Sets the value reducing the intensity of flickering pixels in the screen space. Adjusting this value may cause darkening of the global illumination. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_denoise_information_lost_fix_flicker | | | **Description:** - **Variable.** � Prints the current value reducing the intensity of flickering pixels in the information lost areas. - **Command.** � Sets the value reducing the intensity of flickering pixels in the information lost areas. An excessive value may cause darkening of the areas behind objects when the camera is moving or when objects are moving in space. | **Arguments:** **[0.0f; 1.0f]** - available range **0.75f** - by default | | render_denoise_interleaved | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the interleaved rendering for the Denoiser. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_denoise_information_lost_depth_threshold | | | **Description:** - **Variable.** � Prints the current value defining starting from which depth the noise reduction effect is applied to the data in the "information lost" areas. This setting is aimed at reducing noise in areas where the ghosting effect commonly occurs. - **Command.** � Sets the value defining starting from which depth the noise reduction effect is applied to the data in the "information lost" areas. This setting is aimed at reducing noise in areas where the ghosting effect commonly occurs. | **Arguments:** **[0.0f; inf]** - available range **0.1f** - by default | | render_denoise_radius | | | **Description:** - **Variable.** � Prints the current radius of each blur iteration in noise reduction. - **Command.** � Sets the radius of each blur iteration in noise reduction. This value allows simulating a higher number of blur iterations without affecting performance. However, this may cause such screen-space artefact as insufficiently smooth denoiser blur. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 3]** - available range **1** - by default | | render_denoise_num_blur_iterations | | | **Description:** - **Variable.** � Prints the current number of iterations performed for blurring. - **Command.** � Sets the number of iterations performed for blurring. Higher values increase the blur radius, which helps to reduce noise even in areas with very intense noise. However this greatly affects performance. Recommended values are in range [3, 5]. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0; 10]** - available range **5** - by default | | render_denoise_wrong_velocity_fix_by_depth_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether correction of a wrong velocity during the denoise process is enabled. It helps reduce ghosting artifacts around moving objects. | **Arguments:** **0** - disabled **1** - enabled | | render_denoise_wrong_velocity_fix_by_depth_threshold | | | **Description:** - **Variable.** � Prints the current threshold value of the difference between the depth in the current pixel and the pixel read using reprojection based on velocity. This threshold defines when to applying correction of incorrect velocity during the denoise process. - **Command.** � Sets the threshold value of the difference between the depth in the current pixel and the pixel read using reprojection based on velocity. This threshold defines when to applying correction of incorrect velocity during the denoise process. | **Arguments:** **[0.0f; inf]** - available range **0.03f** - by default | | render_denoise_denoise_mask_bias | | | **Description:** - **Variable.** � Prints the current threshold value for the brightness delta between frames below which the denoise mask becomes black. - **Command.** � Sets the threshold value for the brightness delta between frames below which the denoise mask becomes black. Denoise mask is based on the difference in brightness between the previous frame and the current one. Sometimes this difference is very small and can be neglected. This bias value is the threshold difference below which the denoise mask will be plain black. Since a zero value may cause a slight blur effect on the global illumination, this bias was added to avoid such effect. | **Arguments:** **[0.0f; inf]** - available range **0.001f** - by default | | render_denoise_denoise_mask_denoise_threshold | | | **Description:** - **Variable.** � Prints the current threshold for the pixel brightness delta value of neighboring pixels, which defines if the pixels may be blurred together. - **Command.** � Sets the threshold for the pixel brightness delta value of neighboring pixels, which defines if the pixels may be blurred together. | **Arguments:** **[0.0f; inf]** - available range **0.05f** - by default | | render_denoise_denoise_mask_frame_count | | | **Description:** - **Variable.** � Prints the current number of frames stored to generate the denoise mask. - **Command.** � Sets the number of frames stored to generate the denoise mask. | **Arguments:** **[0.0f; inf]** - available range **15.0f** - by default | | render_denoise_denoise_mask_information_lost_boost | | | **Description:** - **Variable.** � Prints the current value controlling the intensity of filling in the information lost areas with the white color and temporally accumulating the result between frames. - **Command.** � Sets the value controlling the intensity of filling in the information lost areas with the white color and temporally accumulating the result between frames. This parameter reduces the effect of flickering pixels, but may add a ghosting effect. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_denoise_denoise_mask_velocity_threshold | | | **Description:** - **Variable.** � Prints the current threshold for the velocity intensity value at which the denoise mask becomes white. - **Command.** � Sets the threshold for the velocity intensity value at which the denoise mask becomes white. This parameter is used to remove ghosting and flickering pixels when the camera moves quickly. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_indirect_diffuse_temporal_filtering_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if temporal filtering for Indirect Diffuse is enabled. Temporal filtering reduces flickering of indirect diffuse light. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_indirect_diffuse_temporal_filtering_frame_count | | | **Description:** - **Variable.** � Prints the current [frame count](../../principles/render/antialiasing/taa.md#taa_frame_count) of temporal filtering for the indirect diffuse effect. - **Command.** � Sets the [frame count](../../principles/render/antialiasing/taa.md#taa_frame_count) of temporal filtering for the indirect diffuse effect. Specifies the number of frames for the velocity buffer. The higher the value, the more frames are combined into the final image and the better anti-aliasing. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **50.0f** - by default | | render_indirect_diffuse_temporal_filtering_color_clamping_intensity | | | **Description:** - **Variable.** � Prints the current intensity of temporal filtering color clamping at zero pixel velocity for Indirect Diffuse. - **Command.** � Sets the intensity of temporal filtering color clamping at zero pixel velocity for Indirect Diffuse. *Lower* values result in more accumulated frames combined, which reduces noise flickering, but increases ghosting effect. To reduce ghosting in this case you can use Indirect Diffuse Color Clamping Velocity Threshold*[render_indirect_diffuse_temporal_filtering_color_clamping_velocity_threshold](#render_indirect_diffuse_temporal_filtering_color_clamping_velocity_threshold)*, while *higher* values reduce ghosting effect, but increase flickering. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_indirect_diffuse_temporal_filtering_color_clamping_velocity_threshold | | | **Description:** - **Variable.** � Prints the current sensitivity of temporal filtering color clamping for Indirect Diffuse to pixel velocity change. - **Command.** � Sets the sensitivity of temporal filtering color clamping for Indirect Diffuse to pixel velocity change. This parameter is used to reduce ghosting effect for lower Color Clamping Intensity*[render_indirect_diffuse_temporal_filtering_color_clamping_intensity](#render_indirect_diffuse_temporal_filtering_color_clamping_intensity)* values: it automatically increases clamping intensity for higher velocities, and disables clamping for low velocity values. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **100.0f** - by default | | render_indirect_diffuse_denoise_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if noise reduction for Indirect Diffuse is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_indirect_diffuse_denoise_mask_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the denoise mask for Indirect Diffuse is enabled. This mask identifies which portions of the screen should be denoised more, and which - less. This may ensure more detailed ambient lighting. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_indirect_diffuse_denoise_threshold | | | **Description:** - **Variable.** � Prints the current threshold value for color difference of neighboring pixels used for noise reduction for Indirect Diffuse. - **Command.** � Sets the threshold value for color difference of neighboring pixels used for noise reduction for Indirect Diffuse. Blur is applied when the color difference is less than the threshold value. > **Notice:** Setting too high values results in blurring the whole image. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_indirect_specular_normalization | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the adjustment of indirect reflection color and brightness to match the indirect diffuse lighting. When this option is enabled, all indirect specular reflections will attempt to match the brightness and color of the indirect diffuse lighting. This affects both matte and glossy reflections. **Example:** if there is dark indirect diffuse lighting under a table (set by a lightmap, voxel probe, or in another way), then the indirect specular reflection in that area will also appear dark. This effect is physically inaccurate and implemented using a fake approach, so it should be used with caution. In some scenes, it may improve the visual quality, while in others, it may worsen it. Enable the option to observe whether it improves the result or not. This feature is commonly used in many games, especially on consoles, because it's a performance-friendly way to eliminate overly bright reflections in dark areas of the scene. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_indirect_specular_temporal_filtering_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if temporal filtering for Indirect Specular is enabled. Temporal filtering reduces flickering of Indirect Specular lighting. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_indirect_specular_temporal_filtering_frame_count | | | **Description:** - **Variable.** � Prints the current [frame count](../../principles/render/antialiasing/taa.md#taa_frame_count) of temporal filtering for Indirect Specular. - **Command.** � Sets the [frame count](../../principles/render/antialiasing/taa.md#taa_frame_count) of temporal filtering for Indirect Specular. Specifies the number of frames for the velocity buffer. The higher the value, the more frames are combined into the final image and the better anti-aliasing. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **50.0f** - by default | | render_indirect_specular_temporal_filtering_frame_count_grazing | | | **Description:** - **Variable.** � Prints the current number of accumulated frames of temporal filtering for Indirect Specular at grazing angles, where the **[getIndirectSpecularTemporalFilteringColorClampingGrazing_float](#getIndirectSpecularTemporalFilteringColorClampingGrazing_float)** property has relaxed the clamping. Nothing else limits the history there: reflections are reprojected by the velocity of the surface, which does not see the content moving inside the reflection of it. Higher values reduce the noise of reflections and lengthen the smear behind such content. The value is scaled by how much of the clamping has been relaxed, so it has no effect while the clamping is at its full strength. Effective only when the **[isIndirectSpecularTemporalFilteringAngleDependence_int](#isIndirectSpecularTemporalFilteringAngleDependence_int)** option is enabled. - **Command.** � Sets the number of accumulated frames of temporal filtering for Indirect Specular at grazing angles, where the **[getIndirectSpecularTemporalFilteringColorClampingGrazing_float](#getIndirectSpecularTemporalFilteringColorClampingGrazing_float)** property has relaxed the clamping. Nothing else limits the history there: reflections are reprojected by the velocity of the surface, which does not see the content moving inside the reflection of it. Higher values reduce the noise of reflections and lengthen the smear behind such content. The value is scaled by how much of the clamping has been relaxed, so it has no effect while the clamping is at its full strength. Effective only when the **[isIndirectSpecularTemporalFilteringAngleDependence_int](#isIndirectSpecularTemporalFilteringAngleDependence_int)** option is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **4.0f** - by default | | render_indirect_specular_temporal_filtering_angle_dependence | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if temporal filtering for Indirect Specular depends on the angle between the surface and the view direction. Reflections flicker at grazing angles, where the reflection is compressed into a few pixels and the neighboring pixels the clamping range is built from see different content. When enabled, the color clamping is relaxed towards such angles, and the length of the history is bounded along with it, which keeps the relaxed clamping from smearing. Surfaces seen head-on and a moving camera are not affected. Disabled by default. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_indirect_specular_temporal_filtering_color_clamping_grazing | | | **Description:** - **Variable.** � Prints the current intensity of the velocity-independent part of temporal filtering color clamping for Indirect Specular at grazing angles, where the reflection is compressed into a few pixels, so the neighboring pixels the clamping range is built from see different content and the range follows the noise of the trace instead of the signal, which shows up as flickering. Lower values let the history survive there; its length is bounded by the **[getIndirectSpecularTemporalFilteringFrameCountGrazing_float](#getIndirectSpecularTemporalFilteringFrameCountGrazing_float)** property. Surfaces seen head-on and a moving camera are not affected at any value. Effective only when the **[isIndirectSpecularTemporalFilteringAngleDependence_int](#isIndirectSpecularTemporalFilteringAngleDependence_int)** option is enabled. - **Command.** � Sets the intensity of the velocity-independent part of temporal filtering color clamping for Indirect Specular at grazing angles, where the reflection is compressed into a few pixels, so the neighboring pixels the clamping range is built from see different content and the range follows the noise of the trace instead of the signal, which shows up as flickering. Lower values let the history survive there; its length is bounded by the **[getIndirectSpecularTemporalFilteringFrameCountGrazing_float](#getIndirectSpecularTemporalFilteringFrameCountGrazing_float)** property. Surfaces seen head-on and a moving camera are not affected at any value. Effective only when the **[isIndirectSpecularTemporalFilteringAngleDependence_int](#isIndirectSpecularTemporalFilteringAngleDependence_int)** option is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_indirect_specular_temporal_filtering_color_clamping_intensity | | | **Description:** - **Variable.** � Prints the current intensity of temporal filtering color clamping at zero pixel velocity for Indirect Specular. - **Command.** � Sets the intensity of temporal filtering color clamping at zero pixel velocity for Indirect Specular. *Lower* values result in more accumulated frames combined, which reduces noise flickering, but increases ghosting effect. To reduce ghosting in this case you can use Indirect Specular Temporal Filtering Color Clamping Velocity Threshold*[render_indirect_specular_temporal_filtering_color_clamping_velocity_threshold](#render_indirect_specular_temporal_filtering_color_clamping_velocity_threshold)*, while *higher* values reduce ghosting effect, but increase flickering. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_indirect_specular_temporal_filtering_color_clamping_velocity_threshold | | | **Description:** - **Variable.** � Prints the current sensitivity of temporal filtering color clamping for Indirect Specular to pixel velocity change. - **Command.** � Sets the sensitivity of temporal filtering color clamping for Indirect Specular to pixel velocity change. This parameter is used to reduce ghosting effect for lower Color Clamping Intensity*[render_indirect_specular_temporal_filtering_color_clamping_intensity](#render_indirect_specular_temporal_filtering_color_clamping_intensity)* values: it automatically increases clamping intensity for higher velocities, and disables clamping for low velocity values. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **100.0f** - by default | | render_indirect_specular_denoise_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if noise reduction for Indirect Specular is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_indirect_specular_denoise_mask_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the denoise mask for Indirect Specular is enabled.This mask identifies which portions of the screen should be denoised more, and which - less. This may ensure more detailed ambient lighting. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_indirect_specular_denoise_threshold | | | **Description:** - **Variable.** � Prints the current threshold value for color difference of neighboring pixels used for noise reduction for the Indirect Specular effect. - **Command.** � Sets the threshold value for color difference of neighboring pixels used for noise reduction for the Indirect Specular effect. Blur is applied when the color difference is less than the threshold value. > **Notice:** Setting too high values results in blurring the whole image. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_denoise_preset](/code/console/#render_denoise_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_camera_effects_threshold | | | **Description:** - **Variable.** � Prints the current brightness threshold, which is used to detect if an object should be blurred in the HDR mode. - **Command.** � Sets the brightness threshold, which is used to detect if an object should be blurred in the HDR mode. By the minimum value of 0, the bright areas can become overexposed. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_camera_effects_temporal_filtering | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if temporal filtering for camera effects is enabled. Temporal filtering reduces flickering of the bloom effect on the small bright objects (such flickering may appear when the camera moves). For example, it can be used in scenes with industrial pipes. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_camera_effects_temporal_filtering_color_clamping_intensity | | | **Description:** - **Variable.** � Prints the current intensity of TAA color clamping for the Bloom effect. - **Command.** � Sets the intensity of TAA color clamping for the Bloom effect. *Lower* values result in more accumulated frames combined, which reduces noise flickering, but increases ghosting effect. To reduce ghosting in this case you can use Min Velocity Clamping*[render_camera_effects_temporal_filtering_min_velocity_clamping](#render_camera_effects_temporal_filtering_min_velocity_clamping)* and Max Velocity Clamping*[render_camera_effects_temporal_filtering_max_velocity_clamping](#render_camera_effects_temporal_filtering_max_velocity_clamping)*, while *higher* values reduce ghosting effect, but increase flickering. > **Notice:** This option is available only when the temporal filtering*[render_camera_effects_temporal_filtering](#render_camera_effects_temporal_filtering)* is enabled. | **Arguments:** **[1.0f; inf]** - available range **3.0f** - by default | | render_camera_effects_temporal_filtering_min_velocity_clamping | | | **Description:** - **Variable.** � Prints the current sensitivity of TAA color clamping for the Bloom effect for static objects. - **Command.** � Sets the sensitivity of TAA color clamping for the Bloom effect for static objects. This parameter is used to reduce ghosting effect for lower Color Clamping Intensity*[render_camera_effects_temporal_filtering_color_clamping_intensity](#render_camera_effects_temporal_filtering_color_clamping_intensity)* values: higher values reduce ghosting, but at the same time reduce the temporal filter effect. > **Notice:** This option is available only when the temporal filtering*[render_camera_effects_temporal_filtering](#render_camera_effects_temporal_filtering)* is enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.05f** - by default | | render_camera_effects_temporal_filtering_max_velocity_clamping | | | **Description:** - **Variable.** � Prints the current sensitivity of TAA color clamping for the Bloom effect for moving objects. - **Command.** � Sets the sensitivity of TAA color clamping for the Bloom effect for moving objects. This parameter is used to reduce ghosting effect for lower Color Clamping Intensity*[render_camera_effects_temporal_filtering_color_clamping_intensity](#render_camera_effects_temporal_filtering_color_clamping_intensity)* values: higher values reduce ghosting, but at the same time reduce the temporal filter effect. > **Notice:** This option is available only when the temporal filtering*[render_camera_effects_temporal_filtering](#render_camera_effects_temporal_filtering)* is enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_chromatic_aberration | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect is enabled. This effect simulates color shifts in real-world camera lenses due to light rays entering a lens at different points causing separation of RGB colors. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_chromatic_aberration_intensity | | | **Description:** - **Variable.** � Prints the current intensity (strength) of the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect. - **Command.** � Sets the intensity (strength) of the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect. Controls how much color shifting occurs. | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_chromatic_aberration_noise_intensity | | | **Description:** - **Variable.** � Prints the current intensity of noise applied for the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect. - **Command.** � Sets the intensity of noise applied for the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect. | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_chromatic_aberration_samples | | | **Description:** - **Variable.** � Prints the current number of samples used for calculation of the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect. - **Command.** � Sets the number of samples used for calculation of the *[Chromatic Aberration](../../editor2/settings/render_settings/camera_effects/index.md#post_chromatic_aberration)* post-effect. *Higher* values reduce banding making the effect look smoother. | **Arguments:** **[1; 32]** - available range **1** - by default | | render_dirt_scale | | | **Description:** - **Variable.** � Prints the current intensity of lens dirt effect modulating the pattern of lens flares defined by the [Dirt Texture](../../editor2/settings/render_settings/camera_effects/index.md#lens_dirt). - **Command.** � Sets the intensity of lens dirt effect modulating the pattern of lens flares defined by the [Dirt Texture](../../editor2/settings/render_settings/camera_effects/index.md#lens_dirt). For example, it can be used to create an effect of unclean optics when the camera looks at the sun. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_dof | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [DOF](../../editor2/settings/render_settings/camera_effects/index.md) (Depth Of Field) effect is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_dof_preset | | | **Description:** - **Variable.** � Prints the current DoF effect quality preset. To customize the DoF effect options at run time you should activate the **Custom** preset: - **Command.** � Sets the DoF effect quality preset. To customize the DoF effect options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Very Low (by default) **1** - Low **2** - Medium **3** - High **4** - Ultra **5** - Extreme **6** - Custom | | render_dof_blur | | | **Description:** - **Variable.** � Prints the current intensity of [blur](../../editor2/settings/render_settings/camera_effects/index.md#blur) for the DOF (Depth Of Field) effect. - **Command.** � Sets the intensity of [blur](../../editor2/settings/render_settings/camera_effects/index.md#blur) for the DOF (Depth Of Field) effect. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_dof_chromatic_aberration | | | **Description:** - **Variable.** � Prints the current intensity of [chromatic aberration](../../editor2/settings/render_settings/camera_effects/index.md#chromatic_aberration) for the DOF (Depth Of Field) effect. - **Command.** � Sets the intensity of [chromatic aberration](../../editor2/settings/render_settings/camera_effects/index.md#chromatic_aberration) for the DOF (Depth Of Field) effect. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_dof_far_distance | | | **Description:** - **Variable.** � Prints the current [length of the far transition zone](../../editor2/settings/render_settings/camera_effects/index.md#far_distance), over which the blur increases from zero to maximum. - **Command.** � Sets the [length of the far transition zone](../../editor2/settings/render_settings/camera_effects/index.md#far_distance), over which the blur increases from zero to maximum. It is measured away from the camera from the far edge of the in-focus zone. Objects farther than Focal Distance + Far Focal Offset + Far Distance are fully blurred. Black zone on the DOF mask means in-focus zone. | **Arguments:** **[0.0f; inf]** - available range **10.0f** - by default | | render_dof_jitter_samples | | | **Description:** - **Variable.** � Prints the current number of bokeh samples taken per pixel in the jitter sampling mode of the Depth of Field effect. Unlike the ring pattern, whose count comes in fixed steps through the quality preset, jittered sampling takes any count, so it is set directly. The default value is 16. - **Command.** � Sets the number of bokeh samples taken per pixel in the jitter sampling mode of the Depth of Field effect. Unlike the ring pattern, whose count comes in fixed steps through the quality preset, jittered sampling takes any count, so it is set directly. The default value is 16. | **Arguments:** **[1; 1024]** - available range **16** - by default | | render_dof_mipmap_by_blur_intensity | | | **Description:** - **Variable.** � Prints the current value defining how much of the mip level chosen by the blur intensity is taken by the bokeh sampling of the Depth of Field effect, so each sample reads a mip that already averaged the area it stands for. The value of 0 keeps the full resolution, 1 reads the coarsest fitting mip. Reading coarser mips cuts the memory traffic of a wide bokeh and reduces sampling noise, but too high values make the blurred image look coarse. The default value is 0.5. - **Command.** � Sets the value defining how much of the mip level chosen by the blur intensity is taken by the bokeh sampling of the Depth of Field effect, so each sample reads a mip that already averaged the area it stands for. The value of 0 keeps the full resolution, 1 reads the coarsest fitting mip. Reading coarser mips cuts the memory traffic of a wide bokeh and reduces sampling noise, but too high values make the blurred image look coarse. The default value is 0.5. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_dof_near_distance | | | **Description:** - **Variable.** � Prints the current [length of the near transition zone](../../editor2/settings/render_settings/camera_effects/index.md#near_distance), over which the blur increases from zero to maximum. It is measured toward the camera from the near edge of the in-focus zone. - **Command.** � Sets the [length of the near transition zone](../../editor2/settings/render_settings/camera_effects/index.md#near_distance), over which the blur increases from zero to maximum. It is measured toward the camera from the near edge of the in-focus zone. Objects closer than Focal Distance − Near Focal Offset − Near Distance are fully blurred. Black zone on the DOF mask means in-focus zone. | **Arguments:** **[0.0f; inf]** - available range **10.0f** - by default | | render_dof_focal_distance | | | **Description:** - **Variable.** � Prints the current [focal distance](../../editor2/settings/render_settings/camera_effects/index.md#focal_distance) of the camera, i.e. a point where objects are in-focus and visible clearly. - **Command.** � Sets the [focal distance](../../editor2/settings/render_settings/camera_effects/index.md#focal_distance) of the camera, i.e. a point where objects are in-focus and visible clearly. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_dof_far_focal_offset | | | **Description:** - **Variable.** � Prints the current [distance from the focal point away from the camera](../../editor2/settings/render_settings/camera_effects/index.md#far_focal_offset) within which objects stay in focus. - **Command.** � Sets the [distance from the focal point away from the camera](../../editor2/settings/render_settings/camera_effects/index.md#far_focal_offset) within which objects stay in focus. The in-focus zone ends at Focal Distance + Far Focal Offset. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_dof_near_focal_offset | | | **Description:** - **Variable.** � Prints the current [distance from the focal point toward the camera](../../editor2/settings/render_settings/camera_effects/index.md#far_focal_offset) within which objects stay in focus. - **Command.** � Sets the [distance from the focal point toward the camera](../../editor2/settings/render_settings/camera_effects/index.md#far_focal_offset) within which objects stay in focus. The in-focus zone starts at Focal Distance − Near Focal Offset. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_dof_resolution | | | **Description:** - **Variable.** � Prints the current [resolution](../../editor2/settings/render_settings/camera_effects/index.md#resolution) of the DOF (Depth Of Field) effect. - **Command.** � Sets the [resolution](../../editor2/settings/render_settings/camera_effects/index.md#resolution) of the DOF (Depth Of Field) effect. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_dof_preset](/code/console/#render_dof_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - quarter **1** - half **2** - full (by default) | | render_dof_quality | | | **Description:** - **Variable.** � Prints the current [quality](../../editor2/settings/render_settings/camera_effects/index.md#quality) of the DOF (Depth Of Field) effect. - **Command.** � Sets the [quality](../../editor2/settings/render_settings/camera_effects/index.md#quality) of the DOF (Depth Of Field) effect. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_dof_preset](/code/console/#render_dof_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_dof_bokeh_mode | | | **Description:** - **Variable.** � Prints the current shape of the [Bokeh](../../editor2/settings/render_settings/camera_effects/index.md#bokeh_shape) for the DOF effect. - **Command.** � Sets the shape of the [Bokeh](../../editor2/settings/render_settings/camera_effects/index.md#bokeh_shape) for the DOF effect. This parameter determines the way the lens renders out-of-focus points of light. > **Notice:** For the DOF effect, the Bokeh effect is enabled by default. | **Arguments:** **0** - ring (by default) **1** - circle | | render_dof_increased_accuracy | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [increased accuracy](../../editor2/settings/render_settings/camera_effects/index.md#increased_accuracy) option is enabled for the DOF (Depth Of Field) effect. When enabled, focusing calculation is performed with increased accuracy. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_dof_preset](/code/console/#render_dof_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_dof_focus_improvement | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [focus improvement](../../editor2/settings/render_settings/camera_effects/index.md#focus_improvement) option is enabled for the DOF (Depth Of Field) effect. When enabled, transitions between the focused and unfocused parts of the scene become more accurate. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_dof_preset](/code/console/#render_dof_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled | | render_dof_sampling_mode | | | **Description:** bokeh sampling mode of the Depth of Field effect, one of the *DOF_SAMPLING_MODE_** values: a constant ring pattern (default) or per-pixel jittered sampling accumulated by a temporal filter. Effective when the DOF effect is enabled. | | | render_dof_taa_frame_count | | | **Description:** - **Variable.** � Prints the current number of frames accumulated by the temporal filter of the Depth of Field jitter sampling mode; the value of 1 disables the accumulation. Higher values result in a cleaner bokeh but increase the ghosting effect. The default value is 30. - **Command.** � Sets the number of frames accumulated by the temporal filter of the Depth of Field jitter sampling mode; the value of 1 disables the accumulation. Higher values result in a cleaner bokeh but increase the ghosting effect. The default value is 30. | **Arguments:** **[1.0f; inf]** - available range **30.0f** - by default | | render_dof_taa_frames_velocity_threshold | | | **Description:** - **Variable.** � Prints the current threshold defining sensitivity to velocity change for the temporal filter of the Depth of Field jitter sampling mode: higher values discard the accumulated history faster on moving objects, which reduces ghosting but brings the jitter grain back in motion. The default value is 1. - **Command.** � Sets the threshold defining sensitivity to velocity change for the temporal filter of the Depth of Field jitter sampling mode: higher values discard the accumulated history faster on moving objects, which reduces ghosting but brings the jitter grain back in motion. The default value is 1. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_show_emission | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for materials with the *Emission* state enabled or connecting any data to the *Emission* input in the material graph. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_exposure_mode | | | **Description:** - **Variable.** � Prints the current [mode of the adaptive exposure effect](../../editor2/settings/render_settings/camera_effects/index.md#mode). - **Command.** � Sets the [mode of the adaptive exposure effect](../../editor2/settings/render_settings/camera_effects/index.md#mode). - **Static** - a static exposure. The amount of luminance is determined by the Exposure*[render_exposure](#render_exposure)* depending on the Camera Mode*[render_camera_mode](#render_camera_mode)* parameter. - **Logarithmic** - adaptive logarithmic mapping technique. - **Quadratic** - adaptive quadratic mapping technique. - **Curve based** - adaptive curve based mapping technique. | **Arguments:** **0** - static (by default) **1** - logarithmic adaptive exposure **2** - quadratic adaptive exposure | | render_exposure | | | **Description:** - **Variable.** � Prints the current camera [exposure](../../editor2/settings/render_settings/camera_effects/index.md#exposure) (a multiplier of the scene luminance and brightness). - **Command.** � Sets the camera [exposure](../../editor2/settings/render_settings/camera_effects/index.md#exposure) (a multiplier of the scene luminance and brightness). It determines the resulting amount of luminance: Available only when the Camera Mode*[render_camera_mode](#render_camera_mode)* is set to Classic. - By the minimum value of 0.0f, the image is rendered black. - The *higher* the value, the more luminance and the brighter the scene lit. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_exposure_adaptation | | | **Description:** - **Variable.** � Prints the current time for the camera to adjust exposure, in seconds. - **Command.** � Sets the time for the camera to adjust exposure, in seconds. 0.0f - means instant adaptation. If a too small or even negative value is provided, **1E-6** will be used instead. | **Arguments:** **[eps; inf]** - available range **1.0f** - by default | | render_exposure_min_luminance | | | **Description:** - **Variable.** � Prints the current [minimum luminance](../../editor2/settings/render_settings/camera_effects/index.md#min_luminance) offset relative to the default luminance of the scene used for rendering of adaptive exposure effect: the *higher* the value, the darker the adapted image will be. The parameter can take on negative values. > **Notice:** If the specified value is greater than the current maximum luminance, the maximum luminance value will be changed to the specified minimum luminance so that they are equal. - **Command.** � Sets the [minimum luminance](../../editor2/settings/render_settings/camera_effects/index.md#min_luminance) offset relative to the default luminance of the scene used for rendering of adaptive exposure effect: the *higher* the value, the darker the adapted image will be. The parameter can take on negative values. > **Notice:** If the specified value is greater than the current maximum luminance, the maximum luminance value will be changed to the specified minimum luminance so that they are equal. | **Arguments:** **[-10.0f; 10.0f]** - available range **-5.0f** - by default | | render_exposure_max_luminance | | | **Description:** - **Variable.** � Prints the current [maximum luminance](../../editor2/settings/render_settings/camera_effects/index.md#max_luminance) offset relative to the default luminance of the scene used for rendering of adaptive exposure effect: the *lower* the value, the brighter the adapted image will be. The parameter can take on negative values. > **Notice:** If the specified value is less than the current minimum luminance, the minimum luminance value will be changed to the specified maximum luminance so that they are equal. - **Command.** � Sets the [maximum luminance](../../editor2/settings/render_settings/camera_effects/index.md#max_luminance) offset relative to the default luminance of the scene used for rendering of adaptive exposure effect: the *lower* the value, the brighter the adapted image will be. The parameter can take on negative values. > **Notice:** If the specified value is less than the current minimum luminance, the minimum luminance value will be changed to the specified maximum luminance so that they are equal. | **Arguments:** **[-10.0f; 10.0f]** - available range **10.0f** - by default | | render_metering_mask_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if metering mask for exposure and white balance correction is enabled. This option gives you an additional texture slot*[MeteringMaskTexture](#MeteringMaskTexture)* to control the effect of auto exposure and white balance correction on the whole screen, where each pixel is weighted in importance in accordance with the specified texture mask. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_iso | | | **Description:** - **Variable.** � Prints the current ISO value used for static exposure calculation. - **Command.** � Sets the ISO value used for static exposure calculation. This value is available for the physically-based camera*[render_camera_mode](#render_camera_mode)* and represents the sensitivity of the camera sensor. The *higher* the ISO number, the more light is collected and the brighter the image is. | **Arguments:** **[0; inf]** - available range **100** - by default | | render_shutter_speed | | | **Description:** - **Variable.** � Prints the current shutter speed used for static exposure calculation. - **Command.** � Sets the shutter speed used for static exposure calculation. This setting is available for the physically-based camera*[render_camera_mode](#render_camera_mode)* and indicates how long the sensor of the camera is actively collecting light. *Higher* values make the shutter speed faster and the image - darker. | **Arguments:** **[0; inf]** - available range **250** - by default | | render_f_stop | | | **Description:** - **Variable.** � Prints the current f-stop value used for static exposure calculation. - **Command.** � Sets the f-stop value used for static exposure calculation. This setting is available for the physically-based camera*[render_camera_mode](#render_camera_mode)* and represents the ratio of the focal length (f) and the diameter of the lens opening (D): **f / D**. It is the reciprocal of the relative aperture. The *higher* the value, the darker the image is. | **Arguments:** **[0; inf]** - available range **11** - by default | | render_camera_mode | | | **Description:** - **Variable.** � Prints the current camera mode, which determines the way the exposure is set. - **Command.** � Sets the camera mode, which determines the way the exposure is set. Either of the following: - **Physically-Based** - the real-world values are used to set up lighting and camera exposure: ISO*[render_iso](#render_iso)*, shutter speed*[render_shutter_speed](#render_shutter_speed)*, F-stop*[render_f_stop](#render_f_stop)*. With the default values of these parameters, the static exposure value is near 1. > **Notice:** For the physically-based mode, the exposure mode*[render_exposure_mode](#render_exposure_mode)* should be set to *Static* to avoid exposure issues. - **Classic** - the exposure is set by the Exposure value*[render_exposure](#render_exposure)*. | **Arguments:** **0** - classic (by default) **1** - physically-based | | render_white_balance | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [automatic white balance correction](../../editor2/settings/render_settings/camera_effects/index.md#white_balance) is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_white_balance_intensity | | | **Description:** - **Variable.** � Prints the current value of [white balance correction intensity](../../editor2/settings/render_settings/camera_effects/index.md#white_balance_intensity). - **Command.** � Sets the value of [white balance correction intensity](../../editor2/settings/render_settings/camera_effects/index.md#white_balance_intensity). > **Notice:** Do not set too high values for night-time and dimly lit scenes, as it may lead to heavy color distortion making the scene look totally unnatural. - 0.0f - no white balance correction is performed. - *higher* values result in stronger correction. | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_white_balance_adaptation_time | | | **Description:** - **Variable.** � Prints the current time period set for the camera to adjust white balance. - **Command.** � Sets the time period set for the camera to adjust white balance. During this time white balance correction is performed (0.0f - instant correction is to be used). > **Notice:** It is recommended to use lower values, when possible, to make correction process unnoticeable, otherwise it'll be slow and will catch user's eye. However, setting too low values may result in abrupt switching of colors as the camera moves. So, adjust this parameter carefully to make transition smoooth. You can set it equal to the Exposure Adaptation value*[render_exposure_adaptation](#render_exposure_adaptation)*. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_vignette_mask | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of the *[Vignette Mask](../../editor2/settings/render_settings/camera_effects/index.md#post_vignette)* post-effect is enabled. The effect applies darkening towards the edges of an image compared to the center usually caused by thick or stacked filters, secondary lenses, and lens hoods. It can be used for an artistic effect, to draw focus to the center of the image. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_vignette_mask_intensity | | | **Description:** - **Variable.** � Prints the current intensity of the *[Vignette Mask](../../editor2/settings/render_settings/camera_effects/index.md#post_vignette)*. - **Command.** � Sets the intensity of the *[Vignette Mask](../../editor2/settings/render_settings/camera_effects/index.md#post_vignette)*. Defines the amount of vignetting on the screen: *higher* values moke the vignette wider. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_vignette_mask_power | | | **Description:** - **Variable.** � Prints the current Power value that controls mask opacity for the *[Vignette Mask](../../editor2/settings/render_settings/camera_effects/index.md#post_vignette)* post-effect. - **Command.** � Sets the Power value that controls mask opacity for the *[Vignette Mask](../../editor2/settings/render_settings/camera_effects/index.md#post_vignette)* post-effect. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_noise | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of the *[Noise](../../editor2/settings/render_settings/camera_effects/index.md#post_noise)* post-effect is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_noise_intensity | | | **Description:** - **Variable.** � Prints the current intensity of the *[Noise](../../editor2/settings/render_settings/camera_effects/index.md#post_noise)* post-effect. - **Command.** � Sets the intensity of the *[Noise](../../editor2/settings/render_settings/camera_effects/index.md#post_noise)* post-effect. *Higher* values result in more noise applied to the image. | **Arguments:** **[0.0f; inf]** - available range **0.03f** - by default | | color_correction_brightness | | | **Description:** - **Variable.** � Prints the current overall brightness value for the scene. - **Command.** � Sets the overall brightness value for the scene. | **Arguments:** **[-1.0f; 1.0f]** - available range **0.0f** - by default | | color_correction_contrast | | | **Description:** - **Variable.** � Prints the current overall contrast value for the scene. - **Command.** � Sets the overall contrast value for the scene. | **Arguments:** **[-1.0f; 1.0f]** - available range **0.0f** - by default | | color_correction_gamma | | | **Description:** - **Variable.** � Prints the current Gamma correction value for the scene. - **Command.** � Sets the Gamma correction value for the scene. | **Arguments:** **[0.5f; 1.5f]** - available range **1.0f** - by default | | color_correction_white | | | **Description:** - **Variable.** � Prints the current white balance of the scene. - **Command.** � Sets the white balance of the scene. | **Arguments:** **vec4_zero** - default value (black) | | color_correction_by_curves | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if color correction via curves is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | color_correction_hue_per_color | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if fine-adjustment of hue (color shift) for each of the 12 major colors of the spectre is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | color_correction_hue_shift | | | **Description:** - **Variable.** � Prints the current [hue adjustment](../../editor2/settings/render_settings/color/index.md#hue_palette) values for the scene. - **Command.** � Sets the [hue adjustment](../../editor2/settings/render_settings/color/index.md#hue_palette) values for the scene. List of palette colors: 0 - Red, 1 - Orange, 2 - Yellow, 3 - Chartreuse, 4 - Green, 5 - Spring green, 6 - Cyan, 7 - Azure, 8 - Blue, 9 - Violet, 10 - Magenta, 11 - Rose. | **Arguments:** **(0,0,0,0,0,0,0,0,0,0,0,0)** - default value | | color_correction_saturation_per_color | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if fine-adjustment of saturation for each of the 12 major colors of the spectre is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | color_correction_saturation | | | **Description:** - **Variable.** � Prints the current [saturation adjustment](../../editor2/settings/render_settings/color/index.md#saturation_palette) values for the scene. - **Command.** � Sets the [saturation adjustment](../../editor2/settings/render_settings/color/index.md#saturation_palette) values for the scene.List of palette colors: 0 - Red, 1 - Orange, 2 - Yellow, 3 - Chartreuse, 4 - Green, 5 - Spring green, 6 - Cyan, 7 - Azure, 8 - Blue, 9 - Violet, 10 - Magenta, 11 - Rose. | **Arguments:** **(1,1,1,1,1,1,1,1,1,1,1,1)** - default value | | color_correction_preserve_saturation | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if initial scene color saturation is to be preserved after applying color correction. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_supersampling | | | **Description:** - **Variable.** � Prints the current number of samples per pixel used for [supersampling](../../principles/render/antialiasing/supersampling.md). - **Command.** � Sets the number of samples per pixel used for [supersampling](../../principles/render/antialiasing/supersampling.md). | **Arguments:** **[1e-6f; 8.0f]** - available range **1.0f** - by default | | render_occluders | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of occluders is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_occluders_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the texture, to which occluders*[render_occluders](#render_occluders)* are rendered. - **Command.** � Sets the resolution of the texture, to which occluders*[render_occluders](#render_occluders)* are rendered. | **Arguments:** From **1x1** to **1024x1024** Default: **128x64** | | render_occluders_shadows | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether rendering of occluders for shadows is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_occluders_shadows_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the texture, to which occluders for shadows*[render_occluders_shadows](#render_occluders_shadows)* are rendered. - **Command.** � Sets the resolution of the texture, to which occluders for shadows*[render_occluders_shadows](#render_occluders_shadows)* are rendered. | **Arguments:** From **1x1** to **1024x1024** Default: **512x512** | | render_oblique_frustum_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � - **Variable.** Enable oblique frustum support in shaders (required for planar reflections). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_occluder_distance | | | **Description:** - **Variable.** � Prints the current distance starting from which (and farther) occluders will not be rendered. - **Command.** � Sets the distance starting from which (and farther) occluders will not be rendered. | **Arguments:** **[0.0f; inf]** - available range **inf** - by default | | render_ssgi | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [SSGI](../../editor2/settings/render_settings/global_illumination/indirect_diffuse/ssgi/index.md) (Screen Space Global Illumination) effect is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_gi_preset](/code/console/#render_gi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssgi_intensity | | | **Description:** - **Variable.** � Prints the current [intensity](../../editor2/settings/render_settings/global_illumination/indirect_diffuse/ssgi/index.md#ssgi_intensity) of the SSGI (Screen Space Global Illumination) for the scene. - **Command.** � Sets the [intensity](../../editor2/settings/render_settings/global_illumination/indirect_diffuse/ssgi/index.md#ssgi_intensity) of the SSGI (Screen Space Global Illumination) for the scene. By the minimum value of 0.0f, the global illumination is the darkest. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssgi_intensity_boost | | | **Description:** - **Variable.** � Prints the current boost intensity value. - **Command.** � Sets the boost intensity value. Increases the SSGI intensity by raising the value to the specified power. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - power of 1 (by default) **1** - power of 2 **2** - power of 3 **3** - power of 4 | | render_ssgi_information_lost_fix | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the information lost fix option is enabled for the ray-traced SSGI (Screen Space Global Illumination). This option removes artifacts in the information lost areas around moving objects. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssgi_threshold | | | **Description:** - **Variable.** � Prints the current threshold value for the ray-traced SSGI (Screen Space Global Illumination). - **Command.** � Sets the threshold value for the ray-traced SSGI (Screen Space Global Illumination). > **Notice:** Ray-traced SSGI calculation available only when the SSRTGI technique*[render_ssrtgi_preset](#render_ssrtgi_preset)* is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_fxaa | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if FXAA (post-process anti-aliasing) is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_aa_preset](/code/console/#render_aa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_fxaa_intensity | | | **Description:** - **Variable.** � Prints the current intensity of FXAA. - **Command.** � Sets the intensity of FXAA. Intensity specifies the sample offset of FXAA fragment. The higher the value, the more blurred image will be. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_aa_preset | | | **Description:** - **Variable.** � Prints the current index of the AA (Anti-Aliasing) preset used at the moment. To customize Anti-Aliasing options at run time you should activate the **Custom** preset: - **Command.** � Sets the index of the AA (Anti-Aliasing) preset used at the moment. To customize Anti-Aliasing options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Sharpest (by default) **1** - Sharp **2** - Smooth **3** - Smooth + SRAA **4** - Smoothest **5** - Smoothest + SRAA **6** - VR Mode **7** - Custom | | render_surface_id_multilayered | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the transparency, decal, and water surface IDs are stored in separate per-stage buffers instead of being stacked into the scene surface ID buffer. Each per-stage buffer costs one additional *R32U* screen buffer. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_taa | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [TAA (Temporal Anti-Aliasing)](../../principles/render/antialiasing/taa.md) is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_aa_preset](/code/console/#render_aa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_taa_preset | | | **Description:** - **Variable.** � Prints the current TAA (Temporal Anti-Aliasing) preset used at the moment. To customize Anti-Aliasing options at run time you should activate the **Custom** preset: - **Command.** � Sets the TAA (Temporal Anti-Aliasing) preset used at the moment. To customize Anti-Aliasing options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Sharpest (by default) **1** - Sharp **2** - Smooth **3** - Smoothest **4** - VR Mode **5** - Custom | | render_taa_antialiasing_in_motion | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if improved anti-aliasing in motion (for moving camera and objects) is enabled. TAA*[render_taa](#render_taa)* must be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_taa_frame_count | | | **Description:** - **Variable.** � Prints the current [frame count](../../principles/render/antialiasing/taa.md#taa_frame_count) of TAA (Temporal Anti-Aliasing). - **Command.** � Sets the [frame count](../../principles/render/antialiasing/taa.md#taa_frame_count) of TAA (Temporal Anti-Aliasing). Specifies the number of frames combined for pixels. The higher the value, the more frames are combined into the final image and the better anti-aliasing. This value is used only when the Frames By Velocity option*[render_taa_frames_by_velocity](#render_taa_frames_by_velocity)* is disabled. | **Arguments:** **[0.0f; inf]** - available range **30.0f** - by default | | render_taa_catmull_resampling | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if Catmull-Rom resampling is enabled. This option enables you to reduce image blurring when the camera moves forward/backward. It is recommended to disable resampling fow low-quality presets. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_taa_catmull_resampling_sharpness | | | **Description:** - **Variable.** � Prints the current sharpness value for the [Catmull-Rom resampling](#TAACatmullResampling) option. - **Command.** � Sets the sharpness value for the [Catmull-Rom resampling](#TAACatmullResampling) option. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.7f** - by default | | render_taa_frames_by_color | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if TAA [color clamping](../../principles/render/antialiasing/taa.md#taa_color_clamping) option is enabled. This option clamps the color of the current and previous frame. The image becomes more sharp. TAA*[render_taa](#render_taa)* must be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_taa_diagonal_neighbors | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if diagonally neighboring pixels are to be taken into account in the process of color clamping for TAA. This mode can be used for relatively static scenes when improved antialiasing is required. In case of a dynamic scene, blurring artefacts near the screen borders may appear. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_taa_preserve_details | | | **Description:** - **Variable.** � Prints the current [detail level](../../principles/render/antialiasing/taa.md#taa_preserve_details) of TAA (Temporal Anti-Aliasing). - **Command.** � Sets the [detail level](../../principles/render/antialiasing/taa.md#taa_preserve_details) of TAA (Temporal Anti-Aliasing). The higher the value, the more detailed the image is. Can produce additional flickering. | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_taa_pixel_offset | | | **Description:** - **Variable.** � Prints the current size of the sample offset performed during subpixel jittering. - **Command.** � Sets the size of the sample offset performed during subpixel jittering. The offset can be less than a pixel: for example, if **0.5** is set, frames will shift to half a pixel. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_taa_samples | | | **Description:** - **Variable.** � Prints the current number of the sample offsets performed during subpixel jittering. - **Command.** � Sets the number of the sample offsets performed during subpixel jittering. The parameter allows reducing image jittering and blurring. By the minimum value of 0 (1 sample offset), there will be no offsets, and, therefore, no anti-aliasing. TAA*[render_taa](#render_taa)* must be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - 1 sample offset, no anti-aliasing **1** - 4 offsets (by default) **2** - 8 offsets **3** - 16 offsets | | render_taa_frames_by_velocity | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the TAA [velocity clamping](../../principles/render/antialiasing/taa.md#taa_vc_enabled) option is enabled. This option controls the number of frames combined for pixels depending on the velocity in the fragment. It reduces blurring in dynamic scenes with a lot of moving objects. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_taa_frames_velocity_threshold | | | **Description:** - **Variable.** � Prints the current [velocity threshold](../../principles/render/antialiasing/taa.md#taa_vc_threshold) of TAA (Temporal Anti-Aliasing), at which pixels are treated as fast moving ones. - **Command.** � Sets the [velocity threshold](../../principles/render/antialiasing/taa.md#taa_vc_threshold) of TAA (Temporal Anti-Aliasing), at which pixels are treated as fast moving ones.This value specifies the intensity of velocity clamping. The following options must be enabled: TAA*[render_taa](#render_taa)* and TAA velocity clamping*[render_taa_frames_by_velocity](#render_taa_frames_by_velocity)*. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_taa_fix_flicker | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the taa [fix flicker](../../principles/render/antialiasing/taa.md#taa_fix_flicker) option is enabled. This option fixes flickering edges caused by TAA: it removes bright pixels by using the pixel brightness information from the previous frame. It is recommended to enable the option for bright thin ropes, wires and lines. The option is available only when TAA*[render_taa](#render_taa)* is enabled. > **Notice:** Enabling this option may increase performance costs. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_taa_preset](/code/console/#render_taa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_taa_edges_frame_count_multiplier | | | **Description:** - **Variable.** � Prints the current multiplier for the number of frames accumulated for TAA effect on the sharp edges of objects within the image. - **Command.** � Sets the multiplier for the number of frames accumulated for TAA effect on the sharp edges of objects within the image. | **Arguments:** **[1.0f; inf]** - available range **1.0f** - by default | | render_taa_information_lost_depth_threshold | | | **Description:** - **Variable.** � Prints the current threshold value for the depth difference used to calculate information lost areas. "Information lost" refers to rendering of the surfaces that weren't rendered in the prevoius frame. - **Command.** � Sets the threshold value for the depth difference used to calculate information lost areas. "Information lost" refers to rendering of the surfaces that weren't rendered in the prevoius frame. | **Arguments:** **[0.0f; inf]** - available range **0.1f** - by default | | render_sraa | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [Subpixel Reconstruction Anti-Aliasing (SRAA)](../../principles/render/antialiasing/sraa.md) is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_aa_preset](/code/console/#render_aa_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sraa_samples | | | **Description:** - **Variable.** � Prints the current number of depth geometry samples per pixel. - **Command.** � Sets the number of depth geometry samples per pixel. This value may significantly affect performance, so keep it low when the image quality differences are not apparent. | **Arguments:** **0** - 2 **1** - 4 (by default) **2** - 8 | | render_sraa_temporal | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if TAA integration is enabled. SRAA will use the shading sample from the previously rendered frame (TAA) to achieve correct anti-aliasing. Uses camera jittering, so it works only when the TAA*[render_taa](#render_taa)* is enabled. It is recommended to use this option by default. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sraa_debug | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the SRAA debug mode is enabled. This mode shows the geometry edges smoothed by the SRAA. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sraa_depth_threshold | | | **Description:** - **Variable.** � Prints the current depth threshold value used for edges detection that specifies the area for the SRAA processing. - **Command.** � Sets the depth threshold value used for edges detection that specifies the area for the SRAA processing. Turn on the debug mode and adjust this parameter in such a way that covers the required edges but at the same time leaves out the unnecessary geometry in the scene. | **Arguments:** **[0.0f; inf]** - available range **0.1f** - by default | | render_filmic_shoulder_scale | | | **Description:** - **Variable.** � Prints the current [Shoulder Strength](../../editor2/settings/render_settings/color/index.md#shoulder_scale) tonemapping parameter value that is used to change bright values. - **Command.** � Sets the [Shoulder Strength](../../editor2/settings/render_settings/color/index.md#shoulder_scale) tonemapping parameter value that is used to change bright values. | **Arguments:** **[0.0f; 1.0f]** - available range **0.2f** - by default | | render_filmic_linear_scale | | | **Description:** - **Variable.** � Prints the current [Linear Strength](../../editor2/settings/render_settings/color/index.md#linear_scale) tone mapping parameter value that is used to change gray values. - **Command.** � Sets the [Linear Strength](../../editor2/settings/render_settings/color/index.md#linear_scale) tone mapping parameter value that is used to change gray values. The Linear Scale controls the length of the [tone mapping curve](../../editor2/settings/render_settings/color/index.md#tonemapping_curve) linear part. | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_filmic_linear_angle | | | **Description:** - **Variable.** � Prints the current [Linear Angle](../../editor2/settings/render_settings/color/index.md#linear_angle) tone mapping parameter value. - **Command.** � Sets the [Linear Angle](../../editor2/settings/render_settings/color/index.md#linear_angle) tone mapping parameter value. This parameter controls the slope of the linear part of the [tone mapping curve](../../editor2/settings/render_settings/color/index.md#tonemapping_curve). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_filmic_toe_scale | | | **Description:** - **Variable.** � Prints the current [Toe Scale](../../editor2/settings/render_settings/color/index.md#toe_scale) tonemapping parameter value that is used to change dark values. - **Command.** � Sets the [Toe Scale](../../editor2/settings/render_settings/color/index.md#toe_scale) tonemapping parameter value that is used to change dark values. The Toe Scale controls the slope of the tone mapping curve toe (the area of underexposure). | **Arguments:** **[0.0f; 1.0f]** - available range **0.2f** - by default | | render_filmic_toe_numerator | | | **Description:** - **Variable.** � Prints the current [Toe Numerator](../../editor2/settings/render_settings/color/index.md#toe_numerator) tonemapping parameter value. - **Command.** � Sets the [Toe Numerator](../../editor2/settings/render_settings/color/index.md#toe_numerator) tonemapping parameter value. | **Arguments:** **[0.0f; 1.0f]** - available range **0.01f** - by default | | render_filmic_toe_denominator | | | **Description:** - **Variable.** � Prints the current [Toe Denominator](../../editor2/settings/render_settings/color/index.md#toe_denominator) tonemapping parameter value. - **Command.** � Sets the [Toe Denominator](../../editor2/settings/render_settings/color/index.md#toe_denominator) tonemapping parameter value. | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_filmic_white_level | | | **Description:** - **Variable.** � Prints the current [Linear White Point](../../editor2/settings/render_settings/color/index.md#white_level) tonemapping parameter value, which is mapped as pure white in the resulting image. - **Command.** � Sets the [Linear White Point](../../editor2/settings/render_settings/color/index.md#white_level) tonemapping parameter value, which is mapped as pure white in the resulting image. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_filmic_saturation_recovery | | | **Description:** - **Variable.** � Prints the current [color saturation recovery](../../editor2/settings/render_settings/color/index.md#saturation_recovery) value for the filmic tonemapper. - **Command.** � Sets the [color saturation recovery](../../editor2/settings/render_settings/color/index.md#saturation_recovery) value for the filmic tonemapper. Filmic tonemapper desaturates image colors in bright areas making them look grayish. This parameter enables you to recover initial color saturation in such areas. Higher values make colors more saturated: > **Notice:** When the 1.0f value is set specular highlights appear too saturated, so the recommended value is 0.75f (default) - 0.0f - standard filmic tonemapping, no saturation recovery is performed. - 1.0f - color saturation is recovered to the full extent. | **Arguments:** **[0.0f; 1.0f]** - available range **0.75f** - by default | | render_cross | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [cross flares](../../editor2/settings/render_settings/camera_effects/index.md#cross) are enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_cross_color | | | **Description:** - **Variable.** � Prints the current [color](../../editor2/settings/render_settings/camera_effects/index.md#cross_color) of the cross flares. - **Command.** � Sets the [color](../../editor2/settings/render_settings/camera_effects/index.md#cross_color) of the cross flares. To use this option, rendering of cross flares*[render_cross](#render_cross)* should be enabled. | **Arguments:** **vec4_one** - default value (white) | | render_cross_scale | | | **Description:** - **Variable.** � Prints the current [cross color scale](../../editor2/settings/render_settings/camera_effects/index.md#cross_scale) - a multiplier for the [color](#setCrossColor_vec4_void) of cross flares. - **Command.** � Sets the color multiplier.[cross color scale](../../editor2/settings/render_settings/camera_effects/index.md#cross_scale) - a multiplier for the [color](#setCrossColor_vec4_void) of cross flares. *Higher* values produce *more pronounced* flares. To use this option, rendering of cross flares*[render_cross](#render_cross)* should be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_cross_shafts | | | **Description:** - **Variable.** � Prints the current number of [shafts](../../editor2/settings/render_settings/camera_effects/index.md#cross_shafts) in a cross flare. - **Command.** � Sets the number of [shafts](../../editor2/settings/render_settings/camera_effects/index.md#cross_shafts) in a cross flare. High number of flares can cause a FPS drop on low-performance hardware. To use this option, rendering of cross flares*[render_cross](#render_cross)* should be enabled. | **Arguments:** **[2; 32]** - available range **4** - by default | | render_cross_length | | | **Description:** - **Variable.** � Prints the current [length](../../editor2/settings/render_settings/camera_effects/index.md#cross_length) of a cross flare relative to the screen width. - **Command.** � Sets the [length](../../editor2/settings/render_settings/camera_effects/index.md#cross_length) of a cross flare relative to the screen width. *Increasing* this value also leads to fading of the shafts across their length. To use this option, rendering of cross flares*[render_cross](#render_cross)* should be enabled. | **Arguments:** **[0.0f; 2.0f]** - available range **0.2f** - by default | | render_cross_angle | | | **Description:** - **Variable.** � Prints the current cross flares orientation [angle](../../editor2/settings/render_settings/camera_effects/index.md#cross_angle). - **Command.** � Sets the cross flares orientation [angle](../../editor2/settings/render_settings/camera_effects/index.md#cross_angle). To use this option, rendering of cross flares*[render_cross](#render_cross)* should be enabled. | **Arguments:** **[-inf; inf]** - available range **45.0f** - by default | | render_cross_threshold | | | **Description:** - **Variable.** � Prints the current brightness [threshold](../../editor2/settings/render_settings/camera_effects/index.md#cross_threshold) for areas to produce flare - **Command.** � Sets the brightness [threshold](../../editor2/settings/render_settings/camera_effects/index.md#cross_threshold) for areas to produce flare. The *higher* the threshold value, the brighter the area should be to produce a flare. To use this option, rendering of cross flares*[render_cross](#render_cross)* should be enabled. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_distance_scale | | | **Description:** - **Variable.** � Prints the current global distance multiplier for all distance parameters, such as the world rendering distance, [decal distance](#getDecalDistance_float), [field distance](#getFieldDistance_float), [light distance](#getLightDistance_float), [object distance](#getObjectDistance_float), [reflection distance](#getReflectionDistance_float), LODs, and surface visibility distances. - **Command.** � Sets the global distance multiplier for all distance parameters, such as the world rendering distance, [decal distance](#getDecalDistance_float), [field distance](#getFieldDistance_float), [light distance](#getLightDistance_float), [object distance](#getObjectDistance_float), [reflection distance](#getReflectionDistance_float), LODs, and surface visibility distances. This value enables you to easily increase or decrease rendering performance by changing the world extent. Distances are measured from the camera to the node's (surface's) bound. For example, if the maximum visibility distance of a LOD is 10 meters, and you set *Distance Scale = 2*, the LOD will disappear at the distance of 20 meters, not 10. > **Notice:** Increasing the value leads to decreasing the performance. The maximum recommended value is 4. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_distance_offset | | | **Description:** - **Variable.** � Prints the current global distance offset for all distance parameters: shadow distance, light distance, LOD distances, etc. - **Command.** � Sets the global distance offset for all distance parameters: shadow distance, light distance, LOD distances, etc. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_decal_distance | | | **Description:** - **Variable.** � Prints the current distance at which (and farther) decals will not be rendered. - **Command.** � Sets the distance at which (and farther) decals will not be rendered. The distance is measured from the camera to the decal's bound. If the value is greater than the *[World Distance](../../editor2/settings/world/index.md#world_distance)* value, the latter is used instead. | **Arguments:** **[0.0f; inf]** - available range **inf** - by default | | render_field_distance | | | **Description:** - **Variable.** � Prints the current distance at which (and farther) [field](../../objects/effects/fields/index.md) nodes will not be rendered. - **Command.** � Sets the distance at which (and farther) [field](../../objects/effects/fields/index.md) nodes will not be rendered. The distance is measured from the camera to the field's bound. If the value is greater than the *[World Distance](../../editor2/settings/world/index.md#world_distance)* value, the latter is used instead. | **Arguments:** **[0.0f; inf]** - available range **inf** - by default | | render_light_distance | | | **Description:** - **Variable.** � Prints the current distance at which (and farther) lights will not be rendered. - **Command.** � Sets the distance at which (and farther) lights will not be rendered. The distance is measured from the camera to the light's bound. If the value is greater than the *[World Distance](../../editor2/settings/world/index.md#world_distance)* value, the latter is used instead. | **Arguments:** **[0.0f; inf]** - available range **inf** - by default | | render_object_distance | | | **Description:** - **Variable.** � Prints the current distance at which (and farther) objects will not be rendered. - **Command.** � Sets the distance at which (and farther) objects will not be rendered. > **Notice:** If this value is less than the scale multiplier for shadows*[render_shadow_distance_scale](#render_shadow_distance_scale)*, the shadows will still be rendered even though the objects themselves are not. Please, make sure you set these parameters properly to avoid wasting performance on rendering unnecessary shadows. | **Arguments:** **[0.0f; inf]** - available range **inf** - by default | | render_reflection_dynamic | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if dynamic reflections for materials are enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_reflection_dynamic_alpha_fade | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [alpha-blend fading](../../principles/world_management/index.md#fading) (dithering) is enabled for surfaces inside the dynamic reflections when switching between LODs. This feature may be disabled to save performance, but in this case surfaces rendered in dynamic reflections will pop in and pop out. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_reflection_dynamic_roughness_offset | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether roughness offset is enabled for dynamic reflections produced by *Environment Probes*. Sometimes, when specular highlights from glossy surfaces get into dynamic *Environment Probes* a very bright flickering of lighting from it may appear. This option makes surrounding materials look more matte for an *Environment Probe* than they actually are, reducing such flickering artefacts. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_reflection_lods | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if reduction of resolution of dynamic reflections when the camera moves away is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_reflection_distance | | | **Description:** - **Variable.** � Prints the current distance starting from which (and farther) reflections will not be rendered. - **Command.** � Sets the distance starting from which (and farther) reflections will not be rendered. | **Arguments:** **[0.0f; inf]** - available range **inf** - by default | | render_wireframe_color | | | **Description:** - **Variable.** � Prints the current color of the wireframe. - **Command.** � Sets the color of the wireframe. | **Arguments:** **vec4_one** - default value (white) | | render_background_color | | | **Description:** - **Variable.** � Prints the current [background color](../../editor2/settings/render_settings/environment/index.md#background_color) vector. - **Command.** � Sets the [background color](../../editor2/settings/render_settings/environment/index.md#background_color) vector. The Alpha channel of this color sets background transparency: lower alpha channel values produce darker background color. This parameter allows creating colored transparent background instead of rendering an environment cubemap. However, if the environment cubemap is rendered, the background color will always be rendered over the environment. | **Arguments:** **vec4_one** - default value (white) | | render_fade_color | | | **Description:** - **Variable.** � Prints the current fade color for the scene on the screen. - **Command.** � Sets the fade color for the scene on the screen. By gradually changing this value it is possible to create "fade in" and "fade out" effects depending on the w component of the given vector. For example, when the following vectors are passed the result will be: - vec4(1,1,1,1) - a fully white screen. Positive w results in additive blending. - vec4(0.5,0.5,0.5,1) - light colors on the screen. - vec4(1,0,0,1) - R channel for all screen colors is to its maximum; G and B without changes. - vec4(0,0,0,0) - there is no fading (no color alterations are done to the screen). - vec4(1,1,1,-1) - a fully black screen. Negative w results in scene colors * (1 - RGB), where RGB is the first three components of the passed vector. - vec4(0.5,0.5,0.5,-1) - dark colors on the screen. | **Arguments:** **vec4_zero** - default value (white) | | render_lens | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if lens flares are enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_lens_color | | | **Description:** - **Variable.** � Prints the current color of HDR lens flares. - **Command.** � Sets the color of HDR lens flares. To use this option, rendering of lens flares*[render_lens](#render_lens)* should be enabled. | **Arguments:** **vec4_one** - default value (white) | | render_lens_scale | | | **Description:** - **Variable.** � Prints the current multiplier for color*[render_lens_color](#render_lens_color)* of HDR lens flares. - **Command.** � Sets the multiplier for color*[render_lens_color](#render_lens_color)* of HDR lens flares. To use this option, rendering of lens flares*[render_lens](#render_lens)* should be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_lens_length | | | **Description:** - **Variable.** � Prints the current length of the radial lens flare indicating if the whole radial lens flare is rendered on the screen or only a part of it. - **Command.** � Sets the length of the radial lens flare indicating if the whole radial lens flare is rendered on the screen or only a part of it. This option controls how lens flares pattern is distributed. To use this option, rendering of lens flares *[render_lens](#render_lens)* should be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_lens_radius | | | **Description:** - **Variable.** � Prints the current radius of the spherical lens flares on the screen. - **Command.** � Sets the radius of the spherical lens flares on the screen. **1.0f** corresponds to a screen-wide radius (a lens flare is not visible). To use this option, rendering of lens flares*[render_lens](#render_lens)* should be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_lens_threshold | | | **Description:** - **Variable.** � Prints the current value of the brightness threshold for areas to produce lens flares. - **Command.** � Sets the value of the brightness threshold for areas to produce lens flares. The *higher* the threshold value, *the brighter* the area should be to produce flares. To use this option, rendering of lens flares*[render_lens](#render_lens)* should be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_lens_dispersion | | | **Description:** - **Variable.** � Prints the current color displacement for red, green, and blue channels of the lens flares. - **Command.** � Sets the color displacement for red, green, and blue channels of the lens flares. Can be used to create light dispersion (chromatic aberrations). If a negative value is set for a channel, 0 will be used instead. To use this option, rendering of lens flares*[render_lens](#render_lens)* should be enabled. | **Arguments:** **vec3_one** - default value | | render_motion_blur | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the motion blur effect is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_motion_blur_preset | | | **Description:** - **Variable.** � Prints the current Motion Blur preset. To customize the Motion Blur effect options at run time you should activate the **Custom** preset: - **Command.** � Sets the Motion Blur preset. To customize the Motion Blur effect options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High **3** - Ultra **4** - Custom | | render_motion_blur_camera_velocity | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if camera velocity contributes to the [motion blur](../../principles/render/sequence/index.md#motion_blur) effect (false to take into account velocities of objects only). To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Disabled in VR mode by default. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_motion_blur_velocity_blur_samples | | | **Description:** - **Variable.** � Prints the current number of iterations performed to blur the border between moving and static objects. - **Command.** � Sets the number of iterations performed to blur the border between moving and static objects. Higher values ensure a higher quality of blurring, but affect the performance. To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Disabled in VR mode by default. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0; 512]** - available range **32** - by default | | render_motion_blur_velocity_blur_radius | | | **Description:** - **Variable.** � Prints the current radius of the [motion blur](../../principles/render/sequence/index.md#motion_blur) effect for the boundary between moving and static objects. - **Command.** � Sets the radius of the [motion blur](../../principles/render/sequence/index.md#motion_blur) effect for the boundary between moving and static objects. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_motion_blur_depth_threshold_near | | | **Description:** - **Variable.** � Prints the current value defining if the blur effect is applied to the foreground object. - **Command.** � Sets the value defining if the blur effect is applied to the foreground object. If the distance between the foreground object and the background object is less than this threshold value, the motion blur effect won't be applied to the foreground object. To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Disabled in VR mode by default. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **0.2f** - by default | | render_motion_blur_depth_threshold_far | | | **Description:** - **Variable.** � Prints the current value defining if the blur effect is applied to the background object. - **Command.** � Sets the value defining if the blur effect is applied to the background object. If the distance between the foreground object and the background object is less than this threshold value, the motion blur effect won't be applied to the background object. To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Disabled in VR mode by default. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_motion_blur_noise_intensity | | | **Description:** - **Variable.** � Prints the current intensity of the noise used in the [motion blur](../../principles/render/sequence/index.md#motion_blur). - **Command.** � Sets the intensity of the noise used in the [motion blur](../../principles/render/sequence/index.md#motion_blur). To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_motion_blur_num_steps | | | **Description:** - **Variable.** � Prints the current number of steps used in the [motion blur](../../principles/render/sequence/index.md#motion_blur). - **Command.** � Sets the number of steps used in the [motion blur](../../principles/render/sequence/index.md#motion_blur). The higher the value, the more correct the motion blur effect is. At low values, moving objects may look doubled, however, performance will increase. To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[2; 64]** - available range **8** - by default | | render_motion_blur_velocity_scale | | | **Description:** - **Variable.** � Prints the current [scale value](../../editor2/settings/render_settings/camera_effects/index.md#velocity) of bodies' linear and angular velocities used for the motion blur. - **Command.** � Sets the [scale value](../../editor2/settings/render_settings/camera_effects/index.md#velocity) of bodies' linear and angular velocities used for the motion blur. The *higher* the value, the more blurred the objects will appear when moving. To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_motion_blur_max_velocity | | | **Description:** - **Variable.** � Prints the current [maximum possible amount](../../editor2/settings/render_settings/camera_effects/index.md#max_velocity) of [motion blur](../../principles/render/sequence/index.md#motion_blur) for moving physical objects. - **Command.** � Sets the [maximum possible amount](../../editor2/settings/render_settings/camera_effects/index.md#max_velocity) of [motion blur](../../principles/render/sequence/index.md#motion_blur) for moving physical objects. When their body velocity exceeds the set value, they will be blurred as if they have the maximum velocity set by the parameter. This parameter should be used: To use this option, rendering of the motion blur effect*[render_motion_blur](#render_motion_blur)* should be enabled. - To avoid excessive blurring of fast moving objects. - To save performance, as increasing the object's velocity leads increasing the radius of the motion blur effect that drops performance at too high values. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_motion_blur_preset](/code/console/#render_motion_blur_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_transparent_blur | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if transparent blur is enabled for materials. This option makes it possible to render matte transparent materials like matte glass. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_refraction | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if refraction is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_refraction_warp_background_transparent_surfaces | | | **Description:** - **Variable.** � Prints the current value indicating if refraction affects background transparent surfaces (except for water and clouds). - **Command.** � Sets the value indicating if refraction affects background transparent surfaces (except for water and clouds). The following values are available: This method takes effect only when rendering of refractions*[render_refraction](#render_refraction)* is enabled. - Never - no refraction distortion is applied to transparent surfaces. - Behind Farthest Refractive Surface - apply refraction distortion to all transparent surfaces behind the farthest refractive surface. | **Arguments:** **0** - Never (by default) **1** - Behind Farthest Refractive Surface | | render_refraction_dispersion | | | **Description:** - **Variable.** � Prints the current refraction displacement for red, green, and blue channels (according to the refraction texture of refractive materials). - **Command.** � Sets the refraction displacement for red, green, and blue channels (according to the refraction texture of refractive materials). Can be used to create light dispersion (chromatic aberrations). To use this option, render_refraction*[render_refraction](#render_refraction)* should be enabled. | **Arguments:** vec3_one - default value | | render_sharpen | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the sharpening post-processing effect is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sharpen_intensity | | | **Description:** - **Variable.** � Prints the current intensity of the sharpening effect. - **Command.** � Sets the intensity of the sharpening effect. To use this option, sharpening post-processing effect should be enabled*[render_sharpen](#render_sharpen)*. | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_sharpen_blur_color_threshold | | | **Description:** - **Variable.** � Prints the current brightness difference threshold between neighboring pixels to determine whether they should be blurred together when the [sharpening post-processing effect](#render_sharpen) is applied. - **Command.** � Sets the brightness difference threshold between neighboring pixels to determine whether they should be blurred together when the [sharpening post-processing effect](#render_sharpen) is applied. If the brightness difference is below this threshold, the pixels will be blurred as a group. Lower values help avoid visual artifacts such as blooming around objects, harsh shadows, or thin details like wires against the sky. | **Arguments:** **[0.001f; inf]** - available range **0.2f** - by default | | render_sharpen_blur_dark_color_threshold_bias | | | **Description:** - **Variable.** � Prints the current bias value applied to the sharpening blur in dark regions of the image. - **Command.** � Sets the bias value applied to the sharpening blur in dark regions of the image. This value is used in the [sharpening post-processing effect](#render_sharpen) to reduce excessive noise that may occur when sharpening low-light areas during post-processing. | **Arguments:** **[0.0f; 1.0f]** - available range **0.05f** - by default | | render_sharpen_blur_radius | | | **Description:** - **Variable.** � Prints the current radius of the blur applied in the [sharpening post-processing effect](#render_sharpen). - **Command.** � Sets the radius of the blur applied in the [sharpening post-processing effect](#render_sharpen). A radius greater than 1-2 pixels may cause an undesirable blooming effect and negatively affect performance. | **Arguments:** **[1; INT_MAX]** - available range **1** - by default | | render_sharpen_blur_sigma | | | **Description:** - **Variable.** � Prints the current smoothing applied to the Gaussian blur used in the [sharpening post-processing effect](#render_sharpen). - **Command.** � Sets the smoothing applied to the Gaussian blur used in the [sharpening post-processing effect](#render_sharpen). Lower values result in a smoother, less noticeable blur. Such values are effective when the [blur radius](#render_sharpen_blur_radius) is greater than 1 pixel. If the blur radius is set to 1 pixel, a value of 1 is typically sufficient. | **Arguments:** **[0.001f; inf]** - available range **1.0f** - by default | | render_sharpen_diagonal_samples | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating diagonal neighboring pixels are included in the blur calculation, which is a part of the [sharpening post-processing effect](#render_sharpen). When enabled, all eight surrounding pixels affect the blur, resulting in a more rounded and consistent blur shape, but may affect performance. Disabling it limits the effect to only horizontal and vertical neighbors (left, right, top, bottom). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sharpen_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the [sharpening post-processing effect](#render_sharpen). - **Command.** � Sets the resolution of the [sharpening post-processing effect](#render_sharpen). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(2)** | | render_vr_emulation | | | **Description:** - **Variable.** � Prints the current value indicating the current VR emulation mode. The FoV value in any selected mode is 110. - **Command.** � Sets the value indicating the current VR emulation mode. The FoV value in any selected mode is 110. | **Arguments:** **0** - Disabled (by default) **1** - HTC Vive (1512x1680) **2** - HTC Vive Pro (2016x2240) **3** - HTC Vive Pro 2 (3428x3428) **4** - HTC Vive Focus 3(3428x3428) **5** - HTC Vive Focus Vision (3428x3428) **6** - HTC Vive XR Elite (1920x1920) **7** - Oculus Rift (1332x1586) **8** - Quest 2 (2712x2746) **9** - Quest 3S VR (2712x2746) **10** - Quest 3 (2064x2242) **11** - Quest Pro (1800x1950) **12** - Pico 4 (2160x2160) **13** - Valve Index (2016x2240) **14** - Varjo VR-3 (2880x2720) **15** - Varjo VR-4 (3840x3744) | | render_ssr | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the SSR (Screen Space Reflections) effect is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssr_preset | | | **Description:** - **Variable.** � Prints the current SSR (Screen-Space Reflections) preset used at the moment. To customize the SSR effect options at run time you should activate the **Custom** preset: - **Command.** � Sets the SSR (Screen-Space Reflections) preset used at the moment. To customize the SSR effect options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High **3** - Ultra **4** - Extreme **5** - Custom | | render_ssr_alpha_accumulation_mode | | | **Description:** - **Variable.** � Prints the current [accumulation mode](../../editor2/settings/render_settings/sss/index.md#sss_interleaved_color_clamping) for Alpha values used when rendering screen-space reflections. - **Command.** � Sets the [accumulation mode](../../editor2/settings/render_settings/sss/index.md#sss_interleaved_color_clamping) for Alpha values used when rendering screen-space reflections. Two modes are available: - Correct - physically correct implementation. - Boosted - artificial implementation that makes SSR more intense and adds additional contrast to some scenes. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - Correct **1** - Boosted (by default) | | render_ssr_increased_accuracy | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [increased accuracy](../../editor2/settings/render_settings/ssr/index.md#ssr_increased_accuracy) option is enabled for the SSR (Screen Space Reflections). This option increases the accuracy of intersection detection between the ray and surfaces, which makes a reflection on smooth surfaces more detailed. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssr_information_lost_fix | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the information lost fix option is enabled for the SSR (Screen Space Reflections). This option removes artifacts in the information lost areas around moving objects. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssr_resolution | | | **Description:** - **Variable.** � Prints the current [resolution](../../editor2/settings/render_settings/ssr/index.md#ssr_resolution) of SSR (Screen Space Reflections). - **Command.** � Sets the [resolution](../../editor2/settings/render_settings/ssr/index.md#ssr_resolution) of SSR (Screen Space Reflections). > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(1)** | | render_ssr_resolution_depth | | | **Description:** - **Variable.** � Prints the current [resolution](../../editor2/settings/render_settings/ssr/index.md#ssr_resolution_depth) of the depth buffer used for SSR (Screen Space Reflections) calculation. - **Command.** � Sets the [resolution](../../editor2/settings/render_settings/ssr/index.md#ssr_resolution_depth) of the depth buffer used for SSR (Screen Space Reflections) calculation. It affects detailing of reflections of tiny objects. > **Notice:** To gain performance, this option can be set to lower values while enabling increased accuracy*[render_ssr_increased_accuracy](#render_ssr_increased_accuracy)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(0)** | | render_ssr_resolution_color | | | **Description:** - **Variable.** � Prints the current [resolution](../../editor2/settings/render_settings/ssr/index.md#ssr_resolution_depth) of the color buffer used for SSR (Screen Space Reflections) calculation. - **Command.** � Sets the [resolution](../../editor2/settings/render_settings/ssr/index.md#ssr_resolution_depth) of the color buffer used for SSR (Screen Space Reflections) calculation. It significantly affects performance. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(0)** | | render_ssr_perspective_compensation | | | **Description:** - **Variable.** � Prints the current perspective compensation value for the SSR effect. - **Command.** � Sets the perspective compensation value for the SSR effect. At 0.0f, the raymarching step size doesn't depend on the distance from the reflecting surface to the camera. At 1.0f, the raymarching step size linearly depends on the distance from the reflecting surface to the camera. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssr_num_rays | | | **Description:** - **Variable.** � Prints the current [number of SSR rays](../../editor2/settings/render_settings/ssr/index.md#ssr_num_rays) per pixel that are used to calculate rough refrections. - **Command.** � Sets the [number of SSR rays](../../editor2/settings/render_settings/ssr/index.md#ssr_num_rays) per pixel that are used to calculate rough refrections. Using more rays provides more precise SSR roughness calculation, however, it is more expensive. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 64]** - available range **4** - by default | | render_ssr_num_steps | | | **Description:** - **Variable.** � Prints the current [number of SSR steps](../../editor2/settings/render_settings/ssr/index.md#ssr_num_steps) per ray that are used for trace calculation. - **Command.** � Sets the [number of SSR steps](../../editor2/settings/render_settings/ssr/index.md#ssr_num_steps) per ray that are used for trace calculation. The number of steps defines accuracy of reflections and causes a reasonable performance impact. The higher the value, the more accurate obstacles between objects are accounted. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 64]** - available range **16** - by default | | render_ssr_step_size | | | **Description:** - **Variable.** � Prints the current [size of the trace step](../../editor2/settings/render_settings/ssr/index.md#ssr_step_size) used for SSR calculation. - **Command.** � Sets the [size of the trace step](../../editor2/settings/render_settings/ssr/index.md#ssr_step_size) used for SSR calculation. *Higher* values result in longer traces (however, tiny objects may become missing), *lower* values produce more detailed reflections of tiny objects. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_ssr_non_linear_step_size | | | **Description:** - **Variable.** � Prints the current linear step size for the SSR effect. - **Command.** � Sets the linear step size for the SSR effect. At 0.0f, all raymarching steps are of the same size. At 1.0f, each raymarching step is longer than a preceding one, which allows increasing the ray length while keeping the same number of raymarching steps. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssr_visibility_roughness_min | | | **Description:** - **Variable.** � Prints the current [minimum roughness value](../../editor2/settings/render_settings/ssr/index.md#ssr_visibility_roughness_min), starting from which the SSR (Screen-Space Reflections) effect begins to fade out. - **Command.** � Sets the [minimum roughness value](../../editor2/settings/render_settings/ssr/index.md#ssr_visibility_roughness_min), starting from which the SSR (Screen-Space Reflections) effect begins to fade out. It allows reducing noise of reflections on rough materials. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssr_visibility_roughness_max | | | **Description:** - **Variable.** � Prints the current [maximum roughness value](../../editor2/settings/render_settings/ssr/index.md#ssr_visibility_roughness_max), starting from which the SSR (Screen-Space Reflections) effect is not rendered. - **Command.** � Sets the [maximum roughness value](../../editor2/settings/render_settings/ssr/index.md#ssr_visibility_roughness_max), starting from which the SSR (Screen-Space Reflections) effect is not rendered. It allows reducing noise of reflections on rough materials. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssr_roughness_mip_offset | | | **Description:** - **Variable.** � Prints the current mip offset value for the SSR effect on rough surfaces. - **Command.** � Sets the mip offset value for the SSR effect on rough surfaces. Enhances reading a color on rough surfaces on lower-resolution screens. This setting allows reducing the noise and improving performance. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 10.0f]** - available range **4.0f** - by default | | render_ssr_threshold | | | **Description:** - **Variable.** � Prints the current threshold used for SSR (Screen-Space Reflections) calculation to limit imitation of reflections in areas where SSR cannot get information. - **Command.** � Sets the threshold used for SSR (Screen-Space Reflections) calculation to limit imitation of reflections in areas where SSR cannot get information. *Higher* values make the effect less pronounced. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssr_threshold_occlusion | | | **Description:** - **Variable.** � Prints the current value that [limits](../../editor2/settings/render_settings/ssr/index.md#ssr_threshold_occlusion) imitation of environment cubemap occlusion in areas where SSR (Screen-Space Reflections) cannot get information. - **Command.** � Sets the value that [limits](../../editor2/settings/render_settings/ssr/index.md#ssr_threshold_occlusion) imitation of environment cubemap occlusion in areas where SSR (Screen-Space Reflections) cannot get information. *Higher* values make the effect less pronounced. This parameter is mainly used for indoor environment to correct false reflections on occluded areas (false reflections are replaced with black color). For outdoor environment, higher values of this parameter are recommended. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssr_normal_bias | | | **Description:** - **Variable.** � Prints the current bias value to which the ray starting position has been shifted along the normal vector. - **Command.** � Sets the bias value to which the ray starting position has been shifted along the normal vector. This value is used for SSR (Screen-Space Reflections) calculation. Can be adjusted to fine-tune reflections of small objects at far distances. Recommended for narrow FOV angles. To use this option, SSR*[render_ssr](#render_ssr)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssr_view_bias | | | **Description:** - **Variable.** � Prints the current bias value to which the ray starting position has been shifted along the view vector. - **Command.** � Sets the bias value to which the ray starting position has been shifted along the view vector. This value is used for SSR (Screen-Space Reflections) calculation. Can be adjusted to fine-tune reflections of small objects at far distances. Recommended for narrow FOV angles. To use this option, SSR*[render_ssr](#render_ssr)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssr_tonemapping_gamma | | | **Description:** - **Variable.** � Prints the current tonemapping Gamma value for the SSR effect. - **Command.** � Sets the tonemapping Gamma value for the SSR effect. Helps reducing noise for reflections from bright surfaces. 1.0f corresponds to the physically correct value. The recommended value is 2.0f - although it slightly reduces the reflection brightness, it also significantly reduces noise. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssr_preset](/code/console/#render_ssr_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 10.0f]** - available range **2.0f** - by default | | render_ssrtgi_preset | | | **Description:** - **Variable.** � Prints the current index of the SSRTGI (Screen-Space Ray-Traced Global Illumination) preset used at the moment. To customize the SSRTGI effect options at run time you should activate the **Custom** preset: - **Command.** � Sets the index of the SSRTGI (Screen-Space Ray-Traced Global Illumination) preset used at the moment. To customize the SSRTGI effect options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Disabled (by default) **1** - Low **2** - Medium **3** - High **4** - Ultra **5** - Extreme **6** - Custom | | render_ssrtgi_fast_tracing | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if fast tracing is enabled for the SSRTGI (Screen Space Ray-Traced Global Illumination). This option dynamically changes step size to obtain indirect illumination bounces using low number of steps while keeping performance high. Disabling this option improves quality, but significantly reduces performance. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ssrtgi_increased_accuracy | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if increased accuracy is enabled for the SSRTGI (Screen Space Ray-Traced Global Illumination). This option reduces visual artifacts by increasing accuracy of the last step. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ssrtgi_num_rays | | | **Description:** - **Variable.** � Prints the current number of rays of SSRTGI per pixel that are used to calculate the final image. - **Command.** � Sets the number of rays of SSRTGI per pixel that are used to calculate the final image. Using more rays provides more precise SSRTGI calculation, however, it is more expensive. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 1024]** - available range **8** - by default | | render_ssrtgi_num_steps | | | **Description:** - **Variable.** � Prints the current number of steps of SSRTGI per ray that are used for trace calculation. - **Command.** � Sets the number of steps of SSRTGI per ray that are used for trace calculation. The higher the value, the more accurate obstacles between objects are accounted. However, this option significantly affects performance. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 256]** - available range **8** - by default | | render_ssrtgi_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the SSRTGI (screen space ray-traced global illumination) effect. - **Command.** � Sets the resolution of the SSRTGI (screen space ray-traced global illumination) effect. This option significantly affects performance. At low values, edges of objects become blurred. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(1)** | | render_ssrtgi_resolution_depth | | | **Description:** - **Variable.** � Prints the current resolution of the depth buffer used for SSRTGI (screen space ray-traced global illumination) calculation. - **Command.** � Sets the resolution of the depth buffer used for SSRTGI (screen space ray-traced global illumination) calculation. This option significantly affects performance. To gain performance this option can be set to lower values while enabling the increased accuracy*[render_ssrtgi_increased_accuracy](#render_ssrtgi_increased_accuracy)*. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(0)** | | render_ssrtgi_step_size | | | **Description:** - **Variable.** � Prints the current size of the trace step used for SSRTGI calculation. - **Command.** � Sets the size of the trace step used for SSRTGI calculation. The higher the value, the longer the trace. However, tiny objects may be missed. The lower the value, the more detailed will be the tiny objects. The SSRTGI effect must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_ssrtgi_preset](/code/console/#render_ssrtgi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssrtgi_upscaling | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if upscaling is enabled for the SSRTGI (screen space ray-traced global illumination). This option makes the quality of edges in half and quarter resolution look closer to full. SSRTGI must be enabled*[render_ssrtgi_preset](#render_ssrtgi_preset)*. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the SSSSS (Screen-Space Subsurface Scattering) effect is enabled. This effect is used to imitate human skin, wax, etc. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sssss_preset | | | **Description:** - **Variable.** � Prints the current SSSSS (Screen-Space Subsurface Scattering) preset used at the moment. To customize the SSSSS effect options at run time you should activate the **Custom** preset: - **Command.** � Sets the SSSSS (Screen-Space Subsurface Scattering) preset used at the moment. To customize the SSSSS effect options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High **3** - Ultra **4** - Extreme **5** - Custom | | render_sssss_diffuse | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the SSSSS (Screen-Space Subsurface Scattering) calculation for diffuse lighting (directional lights) is enabled. If this option is not required, disable it to save performance. To use this option, the SSSSS effect*[render_sssss](#render_sssss)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss_ambient | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the SSSSS (Screen-Space Subsurface Scattering) calculation for ambient lighting (environment) is enabled. If this option is not required, disable it to save performance. To use this option, the SSSSS effect*[render_sssss](#render_sssss)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sssss_radius | | | **Description:** - **Variable.** � Prints the current [subsurface scattering radius](../../editor2/settings/render_settings/sss/index.md#sss_radius) - distance in the screen space, within which colors will be sampled. - **Command.** � Sets the [subsurface scattering radius](../../editor2/settings/render_settings/sss/index.md#sss_radius) - distance in the screen space, within which colors will be sampled.It controls how much wrinkles, pores and cavities will be blurred and highlighted. The higher the value, the farther subsurface scattering reaches. Too high values result in the ghosting effect. By the minimum value of 0, no subsurface scattering is rendered. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_sssss_color | | | **Description:** - **Variable.** � Prints the current [subsurface scattering color](../../editor2/settings/render_settings/sss/index.md#sss_color) used to simulate the subsurface component of skin lighting, i.e. the light that bounces inside of the subsurface tissue layers (epidermis and dermis) before exiting. - **Command.** � Sets the [subsurface scattering color](../../editor2/settings/render_settings/sss/index.md#sss_color) used to simulate the subsurface component of skin lighting, i.e. the light that bounces inside of the subsurface tissue layers (epidermis and dermis) before exiting.For skin, subsurface color is reddish, due to blood circulating in skin tissues. To use this option, SSSSS effect *[render_sssss](#render_sssss)* should be enabled. | **Arguments:** **vec4(1.0f, 0.0f, 0.0f, 1.0f)** - default value | | render_sssss_max_threshold | | | **Description:** - **Variable.** � Prints the current threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's [Translucent](../../content/materials/library/mesh_base/index.md#parameter_translucency) parameter equal to 1 (maximum translucency). - **Command.** � Sets the threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's [Translucent](../../content/materials/library/mesh_base/index.md#parameter_translucency) parameter equal to 1 (maximum translucency). To use this option, the SSSSS effect*[render_sssss](#render_sssss)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **10.0f** - by default | | render_sssss_min_threshold | | | **Description:** - **Variable.** � Prints the current threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's [Translucent](../../content/materials/library/mesh_base/index.md#parameter_translucency) parameter equal to 0 (minimum translucency). - **Command.** � Sets the threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's [Translucent](../../content/materials/library/mesh_base/index.md#parameter_translucency) parameter equal to 0 (minimum translucency). To use this option, the SSSSS effect*[render_sssss](#render_sssss)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **4.0f** - by default | | render_sssss_noise_ray | | | **Description:** - **Variable.** � Prints the current intensity of the ray noise used for SSSSS (Screen-Space Subsurface Scattering) calculation to reduce banding artifacts of tracing. - **Command.** � Sets the intensity of the ray noise used for SSSSS (Screen-Space Subsurface Scattering) calculation to reduce banding artifacts of tracing. Higher values make banding less visible. To use this option, the SSSSS effect*[render_sssss](#render_sssss)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_sssss_noise_step | | | **Description:** - **Variable.** � Prints the current intensity of the step noise used for SSSSS (Screen-Space Subsurface Scattering) calculation to reduce banding artifacts of tracing. - **Command.** � Sets the intensity of the step noise used for SSSSS (Screen-Space Subsurface Scattering) calculation to reduce banding artifacts of tracing. Higher values make banding less visible. To use this option, the SSSSS effect*[render_sssss](#render_sssss)* should be enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_sssss_interleaved | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [interleaved rendering mode](../../editor2/settings/render_settings/sss/index.md#sss_interleaved) for SSSSS (Screen-Space Subsurface Scattering) is enabled. This option enables rendering of the effect in only half or quarter of all pixels with subsequent reconstruction of neighboring pixels using the data from previous frames, significantly improving performance. The effect is cumulative and works best with *[Temporal Filter](../../editor2/settings/render_settings/sss/index.md#taa)*, which reduces ghosting and noise artifacts. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sssss_interleaved_color_clamping | | | **Description:** - **Variable.** � Prints the current [color clamping mode](../../editor2/settings/render_settings/sss/index.md#sss_interleaved_color_clamping) used to reduce ghosting effect. - **Command.** � Sets the [color clamping mode](../../editor2/settings/render_settings/sss/index.md#sss_interleaved_color_clamping) used to reduce ghosting effect. *Higher* values increase clamping intensity, but may cause flickering (to reduce flickering you can choose **High + Velocity**). When disabled, translucency has a lag as it is several frames behind. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - Disabled **1** - Low (by default) **2** - Medium **3** - High **4** - High + Velocity | | render_sssss_interleaved_samples | | | **Description:** - **Variable.** � Prints the current number of pixels to be skipped when rendering the SSSSS (Screen-Space Subsurface Scattering) effect with subsequent reconstruction of neighboring pixels using the data from previous frames. - **Command.** � Sets the number of pixels to be skipped when rendering the SSSSS (Screen-Space Subsurface Scattering) effect with subsequent reconstruction of neighboring pixels using the data from previous frames. The following options are available: - **1 x 2** (1.0 * width x 0.5 * height) - a half of all pixels is rendered, skipping each second line - **2 x 2** (0.5 * width x 0.5 * height) - a quarter of all pixels is rendered, skipping each second line and row > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - 1 x 2 (by default) **1** - 2 x 2 | | render_sssss_resolution | | | **Description:** - **Variable.** � Prints the current [resolution](../../editor2/settings/render_settings/sss/index.md#sss_resolution) of the SSSSS (Screen-Space Subsurface Scattering) effect. - **Command.** � Sets the [resolution](../../editor2/settings/render_settings/sss/index.md#sss_resolution) of the SSSSS (Screen-Space Subsurface Scattering) effect. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(1)** | | render_sssss_quality | | | **Description:** - **Variable.** � Prints the current [quality](../../editor2/settings/render_settings/sss/index.md#sss_quality) of the SSSSS (Screen-Space Subsurface Scattering) effect. - **Command.** � Sets the [quality](../../editor2/settings/render_settings/sss/index.md#sss_quality) of the SSSSS (Screen-Space Subsurface Scattering) effect. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_sssss_taa | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [TAA (Temporal Anti-Aliasing)](../../principles/render/antialiasing/taa.md) for Screen-Space Subsurface Scattering is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss_taa_fix_flicker | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Fix Flicker](#render_taa_fix_flicker)*[render_taa_fix_flicker](#render_taa_fix_flicker)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss_taa_antialiasing_in_motion | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Antialiasing In Motion](#render_taa_antialiasing_in_motion)*[render_taa_antialiasing_in_motion](#render_taa_antialiasing_in_motion)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_sssss_taa_frames_by_color | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Frames By Color](#render_taa_frames_by_color)*[render_taa_frames_by_color](#render_taa_frames_by_color)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss_taa_frames_by_velocity | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Frames By Velocity](#render_taa_frames_by_velocity)*[render_taa_frames_by_velocity](#render_taa_frames_by_velocity)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss_taa_preserve_details | | | **Description:** - **Variable.** � Prints the current value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Preserve Details](#render_taa_preserve_details)*[render_taa_preserve_details](#render_taa_preserve_details)*. - **Command.** � Sets the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Preserve Details](#render_taa_preserve_details)*[render_taa_preserve_details](#render_taa_preserve_details)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **0.5f** - by default | | render_sssss_taa_frame_count | | | **Description:** - **Variable.** � Prints the current value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Frame Count](#render_taa_frame_count)*[render_taa_frame_count](#render_taa_frame_count)*. - **Command.** � Sets the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Frame Count](#render_taa_frame_count)*[render_taa_frame_count](#render_taa_frame_count)*. | **Arguments:** **[0.0f; inf]** - available range **30.0f** - by default | | render_sssss_taa_frames_velocity_threshold | | | **Description:** - **Variable.** � Prints the current value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Frames Velocity Threshold](#render_taa_frames_velocity_threshold)*[render_taa_frames_velocity_threshold](#render_taa_frames_velocity_threshold)*. - **Command.** � Sets the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Frames Velocity Threshold](#render_taa_frames_velocity_threshold)*[render_taa_frames_velocity_threshold](#render_taa_frames_velocity_threshold)*. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_sssss_taa_pixel_offset | | | **Description:** - **Variable.** � Prints the current value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Pixel Offset](#render_taa_pixel_offset)*[render_taa_pixel_offset](#render_taa_pixel_offset)*. - **Command.** � Sets the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Pixel Offset](#render_taa_pixel_offset)*[render_taa_pixel_offset](#render_taa_pixel_offset)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_sssss_taa_catmull_resampling | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Catmull Resampling](#render_taa_catmull_resampling)*[render_taa_catmull_resampling](#render_taa_catmull_resampling)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_sssss_taa_samples | | | **Description:** - **Variable.** � Prints the current value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Samples](#render_taa_samples)*[render_taa_samples](#render_taa_samples)*. - **Command.** � Sets the value of TAA parameter for Screen-Space Subsurface Scattering that is similar to [TAA Samples](#render_taa_samples)*[render_taa_samples](#render_taa_samples)*. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_sssss_preset](/code/console/#render_sssss_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - 1 sample offset, no anti-aliasing **1** - 4 offsets (by default) **2** - 8 offsets **3** - 16 offsets | | render_translucent_color | | | **Description:** - **Variable.** � Prints the current color used for translucent objects globally. - **Command.** � Sets the color used for translucent objects globally. When light shines on one side of the object, the other side is partially illuminated with this color. | **Arguments:** **vec4(1.0f, 1.0f, 1.0f, 1.0f)** - default value (white) | | render_ssbevel | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the Screen-Space Bevels (SSBevel effect) are enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ssbevel_vertex_normal | | | **Description:** - **Variable.** � Prints the current rendering mode of the screen-space bevels. - **Command.** � Sets the rendering mode of the screen-space bevels. The following modes are available: To use this option, rendering of SSBevel*[render_ssbevel](#render_ssbevel)* should be enabled. - **Better Edges** smoothes vertex and surface normals of the object. In this mode, the relief created by using Normal Mapping will be smoothed along with the mesh edges. - **Better Normals** smoothes only vertex normals. In this mode, only edges of the mesh geometry will be bevelled. The mode may produce visual artifacts on the edges. However, they can be reduced by increasing quality settings of [anti-aliasing](../../principles/render/antialiasing/taa.md). | **Arguments:** **0** - Better Edges (by default) **1** - Better Normals | | render_ssbevel_quality | | | **Description:** - **Variable.** � Prints the current [quality mode](../../editor2/settings/render_settings/ssbevel/index.md#quality) for the screen-space bevels. - **Command.** � Sets the [quality mode](../../editor2/settings/render_settings/ssbevel/index.md#quality) for the screen-space bevels. | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_ssbevel_radius | | | **Description:** - **Variable.** � Prints the current [size](../../editor2/settings/render_settings/ssbevel/index.md#radius) of the Screen-Space Bevel effect. - **Command.** � Sets the [size](../../editor2/settings/render_settings/ssbevel/index.md#radius) of the Screen-Space Bevel effect. To use this option, rendering of SSBevel *[render_ssbevel](#render_ssbevel)* should be enabled. | **Arguments:** **[0.0f; inf]** - available range **0.01f** - by default | | render_ssbevel_noise | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [noise](../../editor2/settings/render_settings/ssbevel/index.md#noise) is enabled for smoothing bevels. It is recommended to use the noise with TAA*[render_taa](#render_taa)* enabled to avoid visual artifacts. The bevel noise is applied at a certain distance from the camera (i.e. if the camera is too far from the object with bevels, the noise won't be applied). To use this option, rendering of SSBevel*[render_ssbevel](#render_ssbevel)* should be enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ssdirt | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [Screen-Space Dirt](../../editor2/settings/render_settings/ssdirt/index.md) (SSDirt) effect is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssdirt_quality | | | **Description:** - **Variable.** � Prints the current [quality](../../editor2/settings/render_settings/ssdirt/index.md#quality) for the SSDirt effect. - **Command.** � Sets the [quality](../../editor2/settings/render_settings/ssdirt/index.md#quality) for the SSDirt effect. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. Quality implies the number of samples used for the Screen-Space Dirt effect: > **Notice:** This parameter significantly affects performance, so choose it reasonably. - Low - 4 samples - Medium - 8 samples - High - 16 samples - Ultra - 32 samples | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(2)** | | render_ssdirt_resolution | | | **Description:** - **Variable.** � Prints the current [resolution](../../editor2/settings/render_settings/ssdirt/index.md#resolution) of the SSDirt effect. - **Command.** � Sets the [resolution](../../editor2/settings/render_settings/ssdirt/index.md#resolution) of the SSDirt effect. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. > **Notice:** This parameter significantly affects performance, so choose it reasonably. | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(1)** | | render_ssdirt_intensity | | | **Description:** - **Variable.** � Prints the current [intensity](../../editor2/settings/render_settings/ssdirt/index.md#intensity) of the SSDirt effect. - **Command.** � Sets the [intensity](../../editor2/settings/render_settings/ssdirt/index.md#intensity) of the SSDirt effect. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. - By the minimum value of 0.0f, the effect is not visible. - *Higher* values make the effect more pronounced. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssdirt_radius | | | **Description:** - **Variable.** � Prints the current [size](../../editor2/settings/render_settings/ssdirt/index.md#radius) of the SSDirt effect. - **Command.** � Sets the [size](../../editor2/settings/render_settings/ssdirt/index.md#radius) of the SSDirt effect. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssdirt_threshold | | | **Description:** - **Variable.** � Prints the current [threshold](../../editor2/settings/render_settings/ssdirt/index.md#threshold) of the SSDirt effect. - **Command.** � Sets the [threshold](../../editor2/settings/render_settings/ssdirt/index.md#threshold) of the SSDirt effect. It determines depth limit for the SSDirt effect in areas where information cannot be obtained. *Higher* values make the effect less pronounced. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_ssdirt_angle_bias | | | **Description:** - **Variable.** � Prints the current angle bias value to limit the [SSDirt](../../editor2/settings/render_settings/ssdirt/index.md) effect where information cannot be obtained. - **Command.** � Sets the angle bias value to limit the [SSDirt](../../editor2/settings/render_settings/ssdirt/index.md) effect where information cannot be obtained. This parameter can be used to remove visual artefacts at the edges of polygons. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. > **Notice:** This parameter affects both, concave and convex areas. | **Arguments:** **[0.0f; 1.0f]** - available range **0.35f** - by default | | render_ssdirt_perspective | | | **Description:** - **Variable.** � Prints the current [perspective](../../editor2/settings/render_settings/ssdirt/index.md#perspective) value, that determines the degree of impact of distance from the camera on the radius of the Screen-Space Dirt effect. - **Command.** � Sets the [perspective](../../editor2/settings/render_settings/ssdirt/index.md#perspective) value, that determines the degree of impact of distance from the camera on the radius of the Screen-Space Dirt effect. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. - 0.0f - radius of the effect is bound to screen space (it remains constant relative to screen size, regardless of the distance to the camera). - 1.0f - radius of the effect is bound to world space (it remains the same relative to objects, i.e. gets smaller as the camera moves away from them). | **Arguments:** **[0.0f; 1.0f]** - available range **0.02f** - by default | | render_ssdirt_increase_accuracy | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if increased accuracy for the [SSDirt](../../editor2/settings/render_settings/ssdirt/index.md) effect. This option should be used to remove visual artefacts along the screen edges, in case if they appear. Otherwise, it should be disabled. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_ssdirt_cavity_texture_size | | | **Description:** - **Variable.** � Prints the current scaling factor for the textures used for cavities. - **Command.** � Sets the scaling factor for the textures used for cavities. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssdirt_cavity_color | | | **Description:** - **Variable.** � Prints the current [color multiplier](../../editor2/settings/render_settings/ssdirt/index.md#cavity_color) for the Albedo texture used for cavities (global dirt and dust color pattern). - **Command.** � Sets the [color multiplier](../../editor2/settings/render_settings/ssdirt/index.md#cavity_color) for the Albedo texture used for cavities (global dirt and dust color pattern). SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **vec4(0.26f, 0.24f, 0.21f, 1.0f)** - default value | | render_ssdirt_cavity_exponent | | | **Description:** - **Variable.** � Prints the current [exponent](../../editor2/settings/render_settings/ssdirt/index.md#cavity_exponent) value that determines the rate of gradual change of intensity along the radius for cavities. - **Command.** � Sets the [exponent](../../editor2/settings/render_settings/ssdirt/index.md#cavity_exponent) value that determines the rate of gradual change of intensity along the radius for cavities. *Lower* values make gradual change of intensity smoother. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssdirt_cavity_metalness | | | **Description:** - **Variable.** � Prints the current [metalness](../../editor2/settings/render_settings/ssdirt/index.md#cavity_metalness) value for cavities. - **Command.** � Sets the [metalness](../../editor2/settings/render_settings/ssdirt/index.md#cavity_metalness) value for cavities. When set to 0 (by default), the SSDirt effect does not modify metalness buffer in cavities. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_ssdirt_cavity_metalness_visibility | | | **Description:** - **Variable.** � Prints the current [metalness visibility](../../editor2/settings/render_settings/ssdirt/index.md#cavity_metalness_visibility) value for cavities. - **Command.** � Sets the [metalness visibility](../../editor2/settings/render_settings/ssdirt/index.md#cavity_metalness_visibility) value for cavities. A multiplier that determines the degree of impact of the effect on metalness buffer (the *higher* the value the more metalness buffer is affected. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_ssdirt_convexity_texture_size | | | **Description:** - **Variable.** � Prints the current scaling factor for the textures used for convexities. - **Command.** � Sets the scaling factor for the textures used for convexities. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssdirt_convexity_color | | | **Description:** - **Variable.** � Prints the current [color multiplier](../../editor2/settings/render_settings/ssdirt/index.md#convexity_color) for the Albedo texture used for convexities (global wear and scratch color pattern). - **Command.** � Sets the [color multiplier](../../editor2/settings/render_settings/ssdirt/index.md#convexity_color) for the Albedo texture used for convexities (global wear and scratch color pattern). SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **vec4(0.48f, 0.44f, 0.39f, 1.0f)** - default value | | render_ssdirt_convexity_exponent | | | **Description:** - **Variable.** � Prints the current [exponent](../../editor2/settings/render_settings/ssdirt/index.md#convexity_exponent) value that determines the rate of gradual change of intensity along the radius for convexities. - **Command.** � Sets the [exponent](../../editor2/settings/render_settings/ssdirt/index.md#convexity_exponent) value that determines the rate of gradual change of intensity along the radius for convexities. *Lower* values make gradual change of intensity smoother. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssdirt_convexity_metalness | | | **Description:** - **Variable.** � Prints the current [metalness](../../editor2/settings/render_settings/ssdirt/index.md#convexity_metalness) value for convexities. - **Command.** � Sets the [metalness](../../editor2/settings/render_settings/ssdirt/index.md#convexity_metalness) value for convexities. When set to 0 (by default), the SSDirt effect does not modify metalness buffer in convex areas. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_ssdirt_convexity_metalness_visibility | | | **Description:** - **Variable.** � Prints the current [metalness visibility](../../editor2/settings/render_settings/ssdirt/index.md#convexity_metalness_visibility) value for convexities. - **Command.** � Sets the [metalness visibility](../../editor2/settings/render_settings/ssdirt/index.md#convexity_metalness_visibility) value for convexities. A multiplier that determines the degree of impact of the effect on metalness buffer (the *higher* the value the more metalness buffer is affected. SSDirt*[render_ssdirt](#render_ssdirt)* must be enabled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_tonemapper | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [tone mapping](../../editor2/settings/render_settings/color/index.md#tonemapper) is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_tonemapper_mode | | | **Description:** - **Variable.** � Prints the current mode of [tone mapping](../../editor2/settings/render_settings/color/index.md#tonemapper). - **Command.** � Sets the mode of [tone mapping](../../editor2/settings/render_settings/color/index.md#tonemapper). | **Arguments:** **0** - Filmic **1** - ACES (by default) **2** - ACES with Reinhard **3** - Reinhard **4** - Reinhard Luma-Based | | render_reinhard_contribution | | | **Description:** - **Variable.** � Prints the current [Reinhard tonemapping](../../editor2/settings/render_settings/color/index.md#contribution_r) operator contribution. - **Command.** � Sets the [Reinhard tonemapping](../../editor2/settings/render_settings/color/index.md#contribution_r) operator contribution. The value is calculated according to the following formula: **C / (1 + C)** It controls the overall contribution that the Reinhard operator makes to the final color grading of the image. The higher values result in more tonemapping contribution to the final image. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_reinhard_luma_based_contribution | | | **Description:** - **Variable.** � Prints the current [Reinhard Luma-Based tonemapping](../../editor2/settings/render_settings/color/index.md#contribution_l) operator contribution. - **Command.** � Sets the [Reinhard Luma-Based tonemapping](../../editor2/settings/render_settings/color/index.md#contribution_l) operator contribution. Controls the overall contribution that the Reinhard operator makes to the final color grading of the image. Higher values result in more tonemapping contribution to the final image. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_aces_with_reinhard_mix | | | **Description:** - **Variable.** � Prints the current [ACES with Reinhard tonemapping](../../editor2/settings/render_settings/color/index.md#mix_with_reinhard) operator contribution. - **Command.** � Sets the [ACES with Reinhard tonemapping](../../editor2/settings/render_settings/color/index.md#mix_with_reinhard) operator contribution. If the value is closer to **0**, then ACES prevails. Otherwise, when the value is closer to **1**, the Reinhard has a grater impact. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_aces_white_clip | | | **Description:** - **Variable.** � Prints the current [white clip](../../editor2/settings/render_settings/color/index.md#white_clip) parameter for the ACES operator. Controls the cut-off point for white. - **Command.** � Sets the [white clip](../../editor2/settings/render_settings/color/index.md#white_clip) parameter for the ACES operator. Controls the cut-off point for white. | **Arguments:** **[0.0f; 10.0f]** - available range **2.51f** - by default | | render_aces_toe | | | **Description:** - **Variable.** � Prints the current [toe](../../editor2/settings/render_settings/color/index.md#toe) parameter for the ACES operator. - **Command.** � Sets the [toe](../../editor2/settings/render_settings/color/index.md#toe) parameter for the ACES operator. Controls the dark color. Higher values result in darker colors. | **Arguments:** **[0.0f; 10.0f]** - available range **0.03f** - by default | | render_aces_shoulder_angle | | | **Description:** - **Variable.** � Prints the current [shoulder angle](../../editor2/settings/render_settings/color/index.md#shoulder_angle) parameter for the ACES operator. - **Command.** � Sets the [shoulder angle](../../editor2/settings/render_settings/color/index.md#shoulder_angle) parameter for the ACES operator. Controls how much overshoot should be added to the curve's shoulder. | **Arguments:** **[0.0f; 10.0f]** - available range **2.43f** - by default | | render_aces_shoulder_strength | | | **Description:** - **Variable.** � Prints the current [shoulder strength](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES operator. - **Command.** � Sets the [shoulder strength](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES operator. Controls the strength of the transition between the curve's midsection and the curve's shoulder. | **Arguments:** **[0.0f; 10.0f]** - available range **0.59f** - by default | | render_aces_shoulder_length | | | **Description:** - **Variable.** � Prints the current [shoulder length](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES operator. - **Command.** � Sets the [shoulder length](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES operator. Controls the amount of f-stops to add to the dynamic range of the curve. Defines how much of the highlights the curve takes into account. | **Arguments:** **[0.0f; 1.0f]** - available range **0.59f** - by default | | render_aces_with_reinhard_white_clip | | | **Description:** - **Variable.** � Prints the current [white clip](../../editor2/settings/render_settings/color/index.md#white_clip) parameter for the ACES with Reinhard operator. - **Command.** � Sets the [white clip](../../editor2/settings/render_settings/color/index.md#white_clip) parameter for the ACES with Reinhard operator. Controls the cut-off point for white.ACES with Reinhard operator's white clip. | **Arguments:** **[0.0f; 10.0f]** - available range **2.51f** - by default | | render_aces_with_reinhard_toe | | | **Description:** - **Variable.** � Prints the current [toe](../../editor2/settings/render_settings/color/index.md#toe) parameter for the ACES with Reinhard operator. - **Command.** � Sets the [toe](../../editor2/settings/render_settings/color/index.md#toe) parameter for the ACES with Reinhard operator. Controls the dark color. Higher values result in darker colors. | **Arguments:** **[0.0f; 10.0f]** - available range **0.03f** - by default | | render_aces_with_reinhard_shoulder_angle | | | **Description:** - **Variable.** � Prints the current [shoulder angle](../../editor2/settings/render_settings/color/index.md#shoulder_angle) parameter for the ACES with Reinhard operator. - **Command.** � Sets the [shoulder angle](../../editor2/settings/render_settings/color/index.md#shoulder_angle) parameter for the ACES with Reinhard operator. Controls how much overshoot should be added to the curve's shoulder. | **Arguments:** **[0.0f; 10.0f]** - available range **2.43f** - by default | | render_aces_with_reinhard_shoulder_strength | | | **Description:** - **Variable.** � Prints the current [shoulder strength](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES with Reinhard operator. - **Command.** � Sets the [shoulder strength](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES with Reinhard operator. Controls the strength of the transition between the curve's midsection and the curve's shoulder. | **Arguments:** **[0.0f; 10.0f]** - available range **0.59f** - by default | | render_aces_with_reinhard_shoulder_length | | | **Description:** - **Variable.** � Prints the current [shoulder length](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES with Reinhard operator. - **Command.** � Sets the [shoulder length](../../editor2/settings/render_settings/color/index.md#shoulder_length) parameter for the ACES with Reinhard operator. Controls the amount of f-stops to add to the dynamic range of the curve. Defines how much of the highlights the curve takes into account. | **Arguments:** **[0.0f; 1.0f]** - available range **0.14f** - by default | | render_local_tonemapper | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the local tonemapper is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_local_tonemapper_num_blur_iterations | | | **Description:** - **Variable.** � Prints the current number of blur iterations applied to the screen texture, which is used to define bright and dark portions of the screen. - **Command.** � Sets the number of blur iterations applied to the screen texture, which is used to define bright and dark portions of the screen. A higher number of iterations increases the blur radius and reduces halo artifacts around objects, but may affect performance. | **Arguments:** **[0; 10]** - available range **5** - by default | | render_local_tonemapper_depth_threshold | | | **Description:** - **Variable.** � Prints the current depth threshold value used to detect the areas affected by local tonemapping. - **Command.** � Sets the depth threshold value used to detect the areas affected by local tonemapping. A properly set value may help to reduce halo artifacts. | **Arguments:** **[0.0f; 1.0f]** - available range **0.9f** - by default | | render_local_tonemapper_tonemapping_intensity | | | **Description:** - **Variable.** � Prints the current intensity of the local tonemapping effect. - **Command.** � Sets the intensity of the local tonemapping effect. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_local_tonemapper_detail_contrast_intensity | | | **Description:** - **Variable.** � Prints the current intensity of the Detail Contrast effect of the local tonemapper, in the [0; 1] range. The default value is 0.5. - **Command.** � Sets the intensity of the Detail Contrast effect of the local tonemapper, in the [0; 1] range. The default value is 0.5. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_local_tonemapper_detail_contrast_radius | | | **Description:** - **Variable.** � Prints the current radius of the Detail Contrast effect, set as the number of blur iterations reused for it, each one doubling the radius: 1 corresponds to 1 texel, 2 to 3 texels, 3 to 7 texels, and so on. Smaller values accentuate finer details and produce narrower halos around objects. The value is always clamped below the number of blur iterations of the local tonemapper. The default value is 2. - **Command.** � Sets the radius of the Detail Contrast effect, set as the number of blur iterations reused for it, each one doubling the radius: 1 corresponds to 1 texel, 2 to 3 texels, 3 to 7 texels, and so on. Smaller values accentuate finer details and produce narrower halos around objects. The value is always clamped below the number of blur iterations of the local tonemapper. The default value is 2. | **Arguments:** **[1; 9]** - available range **2** - by default | | render_local_tonemapper_effect_on_dark_areas | | | **Description:** - **Variable.** � Prints the current extent of applying the local tonemapping effect on dark areas. - **Command.** � Sets the extent of applying the local tonemapping effect on dark areas. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_local_tonemapper_effect_on_dark_areas_gamma | | | **Description:** - **Variable.** � Prints the current gamma correction value for dark areas. Specifying values greater than 1 decreases the local tone mapping effect in extremely dark areas. - **Command.** � Sets the gamma correction value for dark areas. Specifying values greater than 1 decreases the local tone mapping effect in extremely dark areas. | **Arguments:** **[0.0f; inf]** - available range **5.0f** - by default | | render_local_tonemapper_target_middle_gray | | | **Description:** - **Variable.** � Prints the current target middle gray value for tonemapping. - **Command.** � Sets the target middle gray value for tonemapping. | **Arguments:** **[0.0f; 1.0f]** - available range **0.4f** - by default | | render_local_tonemapper_luma_blurred_intensity | | | **Description:** - **Variable.** � Prints the current intensity of blurring the luma values. - **Command.** � Sets the intensity of blurring the luma values. It is recommended to keep the default value for this setting. With the value set to 0, a regular screen texture is used instead of a blurred screen texture. This might be required in a rare case of reducing the halo effect and increasing the tonemapping effect for small details. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_local_tonemapper_debug | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the debug mode for the local tonemapper is enabled. | **Arguments:** **0** - disabled **1** - enabled | | render_local_tonemapper_blur_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the blur applied during the tone mapping process. > **Notice:** It is recommended to use the *Half* resolution in conjunction with the *[Blur Upscale](#LocalTonemapperBlurUpscale)* mode enabled. - **Command.** � Sets the resolution of the blur applied during the tone mapping process. > **Notice:** It is recommended to use the *Half* resolution in conjunction with the *[Blur Upscale](#LocalTonemapperBlurUpscale)* mode enabled. | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(2)** | | render_local_tonemapper_blur_upscale | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether upscaling the blurred image from the *Quarter* or *Half* resolution to the *Full* one is enabled. | **Arguments:** **0** - disabled **1** - enabled | | render_local_tonemapper_blur_upscale_kernel_size | | | **Description:** - **Variable.** � Prints the current size of the kernel used for upscaling the blurred image. The higher the value the better the upscaling quality, but the lower the performance. It is recommended to set the kernel size as follows: - *3x3* for the *Half* resolution. - *5x5* for the *Quarter* resolution. - **Command.** � Sets the size of the kernel used for upscaling the blurred image. The higher the value the better the upscaling quality, but the lower the performance. It is recommended to set the kernel size as follows: - *3x3* for the *Half* resolution. - *5x5* for the *Quarter* resolution. | **Arguments:** **0** - 3x3 (by default) **1** - 5x5 | | render_local_tonemapper_depth_difference_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether considering of the depth difference between objects in the scene is enabled. Enabling this feature allows reducing halo artifacts around objects. However, we recommend using it only in exceptional cases, as it is a performance-costly operation. | **Arguments:** **0** - disabled **1** - enabled | | render_local_tonemapper_color_difference_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether considering of the image color rendered on the screen is enabled. Enabling this feature allows reducing halo artifacts on surfaces with sharp color transitions. For example, it can significantly improve the appearance of a distinct shadow from the sun on asphalt. | **Arguments:** **0** - disabled **1** - enabled | | render_local_tonemapper_color_difference_threshold | | | **Description:** - **Variable.** � Prints the current threshold value that determines the extent to which color differences on the screen are considered. If you set the value to 1, the result will appear as if the [*Color Difference*](#LocalTonemapperColorDifferenceEnabled) feature is turned off. - **Command.** � Sets the threshold value that determines the extent to which color differences on the screen are considered. If you set the value to 1, the result will appear as if the [*Color Difference*](#LocalTonemapperColorDifferenceEnabled) feature is turned off. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_local_tonemapper_use_detail_contrast | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the Detail Contrast effect is enabled: it enhances mid-frequency local contrast on top of the local tonemapper, accentuating surface detail and texture. Useful when the tonemapped image looks flat and needs more visual depth without changing global exposure. Disabled by default. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Upscalers | render_upscale_mode | | |---|---| | **Description:** - **Variable.** � Prints the current Upscaling mode. Defines a technology to be used to render high-resolution images based on the lower resolution source, which may help preserve image quality while getting more fps. - **Command.** � Sets the Upscaling mode. Defines a technology to be used to render high-resolution images based on the lower resolution source, which may help preserve image quality while getting more fps. | **Arguments:** **0** - *Disabled* for no upscaling. 1.0x per dimension, the final image has 100% rendered resolution. (by default) **1** - *FSR* for Fidelity FX Super Resolution by AMD. **2** - *DLSS* for Deep Learning Super Sampling by NVIDIA. | | render_upscale_fix_flicker | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether a temporal filtering pass is applied when upscaling is active to reduce pixel flicker on bright thin details such as wires and lines. May increase rendering costs. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_upscale_order | | | **Description:** - **Variable.** � Prints the current stage of the rendering pipeline at which upscaling is applied. - **Command.** � Sets the stage of the rendering pipeline at which upscaling is applied. | **Arguments:** **0** - upscale before post-effects. (by default) **1** - upscale after color adaptation. **2** - upscale before TAA **3** - upscale after post-effects (before the Sharpen effect) | #### DLSS | dlss_info | | |---|---| | **Description:** - **Command.** Prints the information on the DLSS upscaler: versions of the Streamline SDK and NGX library. | | | render_upscale_dlss_mode | | | **Description:** - **Variable.** � Prints the current DLSS quality. - *Ultra Performance* provides the highest performance boost by rendering at ~33.3% of the target resolution and upscaling to the output resolution. This mode is recommended only for 8K output resolution due to the significant reduction in internal image quality. - *Max Performance* provides a higher performance boost than *Balanced* by rendering at ~50% of the target resolution. Use when frame-rate is prioritized but some internal detail should be preserved. It is recommended for users with 1440p/2K monitors, providing better performance with minimal effort. - *Balanced* offers both optimized performance and image quality by rendering at approximately ~58% of the target resolution. Recommended as the general-purpose preset for users who want a compromise between frame-rate and visual fidelity. - *Max Quality* offers higher image quality than *Balanced* by rendering at approximately ~66.7% of the target resolution. Prioritizes visual fidelity while still delivering a meaningful performance improvement over native rendering. - *DLAA* (**Deep Learning Anti-Aliasing**) is an AI-powered tool to eliminate jagged edges in video apps, by rendering at native (100%) resolution. It improves image quality with less performance cost than traditional anti-aliasing methods. - **Command.** � Sets the DLSS quality. - *Ultra Performance* provides the highest performance boost by rendering at ~33.3% of the target resolution and upscaling to the output resolution. This mode is recommended only for 8K output resolution due to the significant reduction in internal image quality. - *Max Performance* provides a higher performance boost than *Balanced* by rendering at ~50% of the target resolution. Use when frame-rate is prioritized but some internal detail should be preserved. It is recommended for users with 1440p/2K monitors, providing better performance with minimal effort. - *Balanced* offers both optimized performance and image quality by rendering at approximately ~58% of the target resolution. Recommended as the general-purpose preset for users who want a compromise between frame-rate and visual fidelity. - *Max Quality* offers higher image quality than *Balanced* by rendering at approximately ~66.7% of the target resolution. Prioritizes visual fidelity while still delivering a meaningful performance improvement over native rendering. - *DLAA* (**Deep Learning Anti-Aliasing**) is an AI-powered tool to eliminate jagged edges in video apps, by rendering at native (100%) resolution. It improves image quality with less performance cost than traditional anti-aliasing methods. | **Arguments:** **0** - Ultra Performance **1** - Max Performance **2** - Balanced **3** - Max Quality (by default) **4** - DLAA (Deep Learning Anti-Aliasing). | | render_upscale_dlss_preset | | | **Description:** - **Variable.** � Prints the current DLSS preset. - *A* - Legacy preset designed to mitigate ghosting artifacts, particularly in cases where input data (e.g., motion vectors) may be missing. **Intended modes:** Performance, Balanced, Quality - *B* - Variant of Preset A, optimized specifically for Ultra Performance mode. **Intended modes:** Ultra Performance - *C* - Prefers current-frame information, making it well-suited for fast-paced, high-motion content. **Intended modes:** Performance, Balanced, Quality - *D* - Functionally similar to Preset E but less commonly recommended. Preset E is preferred in most cases. **Intended modes:** Performance, Balanced, Quality - *E* - General-purpose preset prioritizing both performance and image stability. **Intended modes:** Performance, Balanced, Quality - *F* - Default preset for Ultra Performance and DLAA modes. Provides stable results across these configurations. **Intended modes:** Ultra Performance, DLAA - *G* is unused. Reverts to default preset behavior. - *H* is unused. Reverts to default preset behavior. - *I* is unused. Reverts to default preset behavior. - *J* - Transformer-based model similar to Preset K. May exhibit slightly less ghosting, but at the cost of additional flickering. Generally superseded by Preset K. **Intended modes:** DLAA, Performance, Balanced, Quality - *K* - Default transformer-based preset delivering the highest image quality. Reduces ghosting and shimmering compared to other presets, though at a higher performance cost. Recommended over Preset J. **Intended modes:** DLAA, Performance, Balanced, Quality - **Command.** � Sets the DLSS preset. - *A* - Legacy preset designed to mitigate ghosting artifacts, particularly in cases where input data (e.g., motion vectors) may be missing. **Intended modes:** Performance, Balanced, Quality - *B* - Variant of Preset A, optimized specifically for Ultra Performance mode. **Intended modes:** Ultra Performance - *C* - Prefers current-frame information, making it well-suited for fast-paced, high-motion content. **Intended modes:** Performance, Balanced, Quality - *D* - Functionally similar to Preset E but less commonly recommended. Preset E is preferred in most cases. **Intended modes:** Performance, Balanced, Quality - *E* - General-purpose preset prioritizing both performance and image stability. **Intended modes:** Performance, Balanced, Quality - *F* - Default preset for Ultra Performance and DLAA modes. Provides stable results across these configurations. **Intended modes:** Ultra Performance, DLAA - *G* is unused. Reverts to default preset behavior. - *H* is unused. Reverts to default preset behavior. - *I* is unused. Reverts to default preset behavior. - *J* - Transformer-based model similar to Preset K. May exhibit slightly less ghosting, but at the cost of additional flickering. Generally superseded by Preset K. **Intended modes:** DLAA, Performance, Balanced, Quality - *K* - Default transformer-based preset delivering the highest image quality. Reduces ghosting and shimmering compared to other presets, though at a higher performance cost. Recommended over Preset J. **Intended modes:** DLAA, Performance, Balanced, Quality | **Arguments:** **0** - Default (by default) **1** - Preset A **2** - Preset B **3** - Preset C **4** - Preset D **5** - Preset E **6** - Preset F **7** - Preset G **8** - Preset H **9** - Preset I **10** - Preset J **11** - Preset K | | render_upscale_dlss_resolution_scale_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether a custom resolution scale is used instead of the default render resolution provided by DLSS for the current [DLSSMode](#DLSSMode). When enabled, the render resolution is adjusted within the allowed range for the current mode using the [DLSSResolutionScaleValue](#DLSSResolutionScaleValue). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_upscale_dlss_resolution_scale_value | | | **Description:** - **Variable.** � Prints the current custom resolution scale for DLSS within the allowed range for the current [DLSSMode](#DLSSMode) and output resolution, where 0.0 is the minimum and 1.0 is the maximum render resolution. [DLSSResolutionScaleEnabled](#DLSSResolutionScaleEnabled) must be enabled for this value to take effect. - **Command.** � Sets the custom resolution scale for DLSS within the allowed range for the current [DLSSMode](#DLSSMode) and output resolution, where 0.0 is the minimum and 1.0 is the maximum render resolution. [DLSSResolutionScaleEnabled](#DLSSResolutionScaleEnabled) must be enabled for this value to take effect. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | dlss_application_id | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current DLSS Application ID, provided by NVIDIA. - **Command.** � Sets the DLSS Application ID, provided by NVIDIA. > **Notice:** If no NVIDIA Application ID is available, the Engine uses its own generated project ID instead. | **Arguments:** **[INT_MIN; INT_MAX]** - available range **0** - by default | | dlss_log_mode | | | **Description:** - **Variable.** � Prints the current level of DLSS log output. - **Command.** � Sets the level of DLSS log output. | **Arguments:** **0** - Off (by default) **1** - Default (standard logging) **2** - Verbose (detailed logging) | | dlss_max_contexts | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current maximum number of DLSS contexts (up to 16) at engine startup. This enables better performance management, especially for hardware capable of handling multiple viewports without significant performance loss. - **Command.** � Sets the maximum number of DLSS contexts (up to 16) at engine startup. This enables better performance management, especially for hardware capable of handling multiple viewports without significant performance loss. | **Arguments:** **[1; 16]** - available range **8** - by default | #### FSR | fsr_info | | |---|---| | **Description:** - **Command.** Prints the information on the FSR upscaler: a version and the number of contexts. | | | fsr_debug_checking | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Sets a value indicating if debug checking is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | fsr_max_contexts | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current number of the FSR contexts. - **Command.** � Sets the number of the FSR contexts. | **Arguments:** **[1; 16]** - available range **8** - by default | | render_upscale_fsr_mode | | | **Description:** - **Variable.** � Prints the current quality mode of FSR (FidelityFX Super Resolution upsampling technique). - *Ultra Performance* that offers the highest performance gain while still retaining image quality close to native. Scale factor: 3.0x per dimension (≈33.3% of output resolution) - *Performance* that delivers a substantial performance boost with image quality similar to native rendering. Scale factor: 2.0x per dimension (≈50.0% of output resolution) - *Balanced* that balances performance gains and image quality effectively. Scale factor: 1.7x per dimension (≈58.8% of output resolution) - *Quality* that provides image quality equal to or better than native with a meaningful performance improvement. Scale factor: 1.5x per dimension (≈66.6% of output resolution) - *Native AA* that renders at native resolution (no upscaling, scale factor 1.0x) and applies FSR anti-aliasing only. - *Custom* that uses a custom resolution scale set via the [FSRCustomResolutionScale](#FSRCustomResolutionScale) property (range: 0.1 to 1.0). - **Command.** � Sets the quality mode of FSR (FidelityFX Super Resolution upsampling technique). - *Ultra Performance* that offers the highest performance gain while still retaining image quality close to native. Scale factor: 3.0x per dimension (≈33.3% of output resolution) - *Performance* that delivers a substantial performance boost with image quality similar to native rendering. Scale factor: 2.0x per dimension (≈50.0% of output resolution) - *Balanced* that balances performance gains and image quality effectively. Scale factor: 1.7x per dimension (≈58.8% of output resolution) - *Quality* that provides image quality equal to or better than native with a meaningful performance improvement. Scale factor: 1.5x per dimension (≈66.6% of output resolution) - *Native AA* that renders at native resolution (no upscaling, scale factor 1.0x) and applies FSR anti-aliasing only. - *Custom* that uses a custom resolution scale set via the [FSRCustomResolutionScale](#FSRCustomResolutionScale) property (range: 0.1 to 1.0). | **Arguments:** **0** - Ultra Performance **1** - Performance **2** - Balanced **3** - Quality (by default) **4** - Native AA **5** - Custom | | render_upscale_fsr_enable_sharpness | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if additional sharpness pass for FidelityFX Super Resolution upscaling is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_upscale_fsr_sharpness | | | **Description:** - **Variable.** � Prints the current sharpness value - **Command.** � Sets the sharpness value, where 0 is no additional sharpness and 1 is maximum additional sharpness. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_upscale_fsr_pre_exposure | | | **Description:** - **Variable.** � Prints the current pre-exposure value - **Command.** � Sets the pre-exposure value by which we divide the input signal to get back to the original signal produced by the game before any packing into lower precision render targets. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_upscale_fsr_custom_resolution_scale | | | **Description:** - **Variable.** � Prints the current custom resolution scale used when [FSRMode](#FSRMode) is set to *Custom*. The value directly multiplies the output resolution to determine the internal render resolution. - **Command.** � Sets the custom resolution scale used when [FSRMode](#FSRMode) is set to *Custom*. The value directly multiplies the output resolution to determine the internal render resolution. | **Arguments:** **[0.1f; 1.0f]** - available range **0.5f** - by default | | render_upscale_fsr_show_debug_view | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if FSR debug view is enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_upscale_fsr_use_old_frame_reactivity | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables using the reactive mask of the previous frame for FSR upscaling instead of the mask rendered for the current frame. A persistent copy of the mask is kept and fed to the upscaler, which costs an additional full-resolution texture plus one copy per frame. | **Arguments:** **0** - disabled **1** - enabled (by default) | ### Dynamic Resolution Scaling | render_dynamic_resolution_enabled | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the [Dynamic Resolution Scaling](../../principles/render/drs/index.md). When enabled, the engine can automatically adjust the internal rendering resolution based on GPU frame time to maintain the target frame rate. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_dynamic_resolution_scale_min | | | **Description:** - **Variable.** � Prints the current minimum dynamic resolution scale relative to the target resolution. For example, if the target resolution is 3840 � 2160 and the minimum scale is 0.5, the internal rendering resolution can be reduced down to 1920 � 1080. - **Command.** � Sets the minimum dynamic resolution scale relative to the target resolution. For example, if the target resolution is 3840 � 2160 and the minimum scale is 0.5, the internal rendering resolution can be reduced down to 1920 � 1080. | **Arguments:** **[0.1f; 1.0f]** - available range **0.275f** - by default | | render_dynamic_resolution_scale_max | | | **Description:** - **Variable.** � Prints the current maximum dynamic resolution scale relative to the target resolution. A value of 1.0 means that the internal rendering resolution can reach the full target resolution. - **Command.** � Sets the maximum dynamic resolution scale relative to the target resolution. A value of 1.0 means that the internal rendering resolution can reach the full target resolution. | **Arguments:** **[0.1f; 1.0f]** - available range **1.0f** - by default | | render_dynamic_resolution_dimension | | | **Description:** - **Variable.** � Prints the current mode that defines which dimension is affected by dynamic resolution scaling. - **Command.** � Sets the mode that defines which dimension is affected by dynamic resolution scaling. | **Arguments:** **0** - uniform scaling (by default) **1** - horizontal scaling **2** - vertical scaling | | render_dynamic_resolution_step | | | **Description:** - **Variable.** � Prints the current resolution scale step used when increasing or decreasing the internal rendering resolution. Larger values result in more noticeable resolution changes, while smaller values provide smoother transitions. - **Command.** � Sets the resolution scale step used when increasing or decreasing the internal rendering resolution. Larger values result in more noticeable resolution changes, while smaller values provide smoother transitions. | **Arguments:** **[0.01f; 1.0f]** - available range **0.05f** - by default | | render_dynamic_resolution_down_threshold | | | **Description:** - **Variable.** � Prints the current GPU frame time threshold for decreasing the internal rendering resolution. When GPU timings exceed the target frame time by this threshold, DRS may reduce the resolution. - **Command.** � Sets the GPU frame time threshold for decreasing the internal rendering resolution. When GPU timings exceed the target frame time by this threshold, DRS may reduce the resolution. | **Arguments:** **[0.0f; 2.0f]** - available range **0.95f** - by default | | render_dynamic_resolution_up_threshold | | | **Description:** - **Variable.** � Prints the current GPU frame time threshold for increasing the internal rendering resolution. When GPU timings remain below the target frame time by this threshold, DRS may increase the resolution. - **Command.** � Sets the GPU frame time threshold for increasing the internal rendering resolution. When GPU timings remain below the target frame time by this threshold, DRS may increase the resolution. | **Arguments:** **[0.0f; 2.0f]** - available range **1.05f** - by default | | render_dynamic_resolution_warmup_frames | | | **Description:** - **Variable.** � Prints the current number of frames rendered at the maximum resolution after startup before Dynamic Resolution Scaling starts adjusting the resolution. - **Command.** � Sets the number of frames rendered at the maximum resolution after startup before Dynamic Resolution Scaling starts adjusting the resolution. | **Arguments:** **[0; 1000]** - available range **30** - by default | | render_dynamic_resolution_down_frames | | | **Description:** - **Variable.** � Prints the current number of consecutive frames that must exceed the downscale threshold before DRS decreases the internal rendering resolution. - **Command.** � Sets the number of consecutive frames that must exceed the downscale threshold before DRS decreases the internal rendering resolution. | **Arguments:** **[0; 1000]** - available range **3** - by default | | render_dynamic_resolution_up_frames | | | **Description:** - **Variable.** � Prints the current number of consecutive frames that must stay below the upscale threshold before DRS increases the internal rendering resolution. - **Command.** � Sets the number of consecutive frames that must stay below the upscale threshold before DRS increases the internal rendering resolution. | **Arguments:** **[0; 1000]** - available range **30** - by default | | render_dynamic_resolution_cooldown_frames | | | **Description:** - **Variable.** � Prints the current number of frames during which the rendering resolution is kept unchanged after a resolution adjustment. This prevents the resolution from changing too frequently. - **Command.** � Sets the number of frames during which the rendering resolution is kept unchanged after a resolution adjustment. This prevents the resolution from changing too frequently. | **Arguments:** **[0; 1000]** - available range **10** - by default | | render_dynamic_resolution_target_fps | | | **Description:** - **Variable.** � Prints the current target frame rate used by Dynamic Resolution Scaling. DRS compares GPU timings against this value and adjusts the internal rendering resolution accordingly. - **Command.** � Sets the target frame rate used by Dynamic Resolution Scaling. DRS compares GPU timings against this value and adjusts the internal rendering resolution accordingly. | **Arguments:** **[1; 1000]** - available range **60** - by default | | render_dynamic_resolution_alignment_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if alignment of dynamic rendering resolutions to reduce texture reallocations when the resolution changes. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_dynamic_resolution_debug | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Sets a value indicating if debug mode is enabled that rapidly cycles through available dynamic resolution values. This can be used to visually check how different rendering resolutions affect image quality and performance. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Lighting and Shading Operations on lighting and shading. | render_environment | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of environment of the scene is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_environment_cubemap_blend | | | **Description:** - **Variable.** � Prints the current blending mode for the environment cubemap. - **Command.** � Sets the blending mode for the environment cubemap. | **Arguments:** **0** - alpha blend (by default) **1** - additive blend **2** - multiply **3** - overlay | | render_environment_dither_scale | | | **Description:** - **Variable.** � Prints the current dithering intensity for environment rendering. Dithering adds subtle noise to reduce color banding in environment gradients. - **Command.** � Sets the dithering intensity for environment rendering. Dithering adds subtle noise to reduce color banding in environment gradients. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_environment_ggx_mipmaps_quality | | | **Description:** - **Variable.** � Prints the current GGX Mipmap quality mode for environment reflections on rough surfaces. - **Command.** � Sets the GGX Mipmap quality mode for environment reflections on rough surfaces. Quality modes differ in the number of rays used to create a reflection on a rough surface. | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(0)** | | render_environment_hemisphere | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of environment only for the top (above-ground) hemisphere is enabled. The underground is rendered black. When disabled, environment for the whole sphere is rendered. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_environment_haze | | | **Description:** - **Variable.** � Prints the current [mode](../../editor2/settings/render_settings/environment/index.md#haze) for the haze effect. - **Command.** � Sets the [mode](../../editor2/settings/render_settings/environment/index.md#haze) for the haze effect. - If **Disabled**, no haze is applied. - The **Solid** mode uses the solid color from the *[Color](../../editor2/settings/render_settings/environment/index.md#haze_color)* parameter. - The **Scattering** mode uses the color from the sky LUTs is blended with the *[Color](../../editor2/settings/render_settings/environment/index.md#haze_color)* parameter. This value is recommended for better realism: objects will smoothly fade into the distance. | **Arguments:** **0** - haze disabled **1** - haze colored the specific color **2** - haze colored in accordance with the sky LUT (by default) | | render_environment_haze_gradient | | | **Description:** - **Variable.** � Prints the current environment haze gradient mode. - **Command.** � Sets the environment haze gradient mode. By using this option, you can make the haze look more realistic for a specific distance range. - Short Distance Range - better suitable for near-surface haze - Long Distance Range - better suitable for hazy mountains - Physically Based - for physically based haze simulation | **Arguments:** **0** - Short Distance Range (by default) **1** - Long Distance Range **2** - Physically Based | | render_environment_haze_resolution | | | **Description:** - **Variable.** � Prints the current resolution scale for rendering the environment haze effect (quarter, half, or full). Lower values improve performance at the cost of quality. - **Command.** � Sets the resolution scale for rendering the environment haze effect (quarter, half, or full). Lower values improve performance at the cost of quality. | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(2)** | | render_environment_haze_screen_space_global_illumination | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the Screen-Space Haze Global Illumination effect is enabled. SSHGI - is a screen-space effect ensuring consistency of haze color with the current color of Global Illumination. > **Notice:** Available for **Physically Based** [haze gradient mode](#render_environment_haze_gradient) only. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_environment_haze_screen_space_global_illumination_distance_min | | | **Description:** - **Variable.** � Prints the current minimum distance at which Screen Space Haze GI calculations start to take effect. - **Command.** � Sets the minimum distance at which Screen Space Haze GI calculations start to take effect. | **Arguments:** **[0.0f; inf]** - available range **98000.0f** - by default | | render_environment_haze_screen_space_global_illumination_distance_max | | | **Description:** - **Variable.** � Prints the current maximum distance within which Screen Space Haze GI calculations are performed. - **Command.** � Sets the maximum distance within which Screen Space Haze GI calculations are performed. | **Arguments:** **[0.0f; inf]** - available range **100000.0f** - by default | | render_environment_haze_temporal_filter | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if temporal filtering for the Screen-Space Haze Global Illumination effect is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_environment_haze_colorization_threshold | | | **Description:** - **Variable.** � Prints the current treshold value for scene depth used when setting haze color for the SSHGI effect in "information lost" areas on the screen. - 0 - haze color is defined only by surfaces currently visible on the screen. - 1 - haze color is defined by surfaces everywhere, even in "information lost" areas. - **Command.** � Sets the treshold value for scene depth used when setting haze color for the SSHGI effect in "information lost" areas on the screen. - 0 - haze color is defined only by surfaces currently visible on the screen. - 1 - haze color is defined by surfaces everywhere, even in "information lost" areas. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_environment_haze_colorization_intensity | | | **Description:** - **Variable.** � Prints the current colorization intensity value that defines haze color in "information lost" areas on the screen. - **Command.** � Sets the colorization intensity value that defines haze color in "information lost" areas on the screen. This parameter is ignored when *[Colorization Threshold](#render_environment_haze_colorization_threshold)* is set to 1, as there will be no "information lost" areas not covered by SSHGI. - 0 - haze in "information lost" areas will have the initial color (same as it would be without SSHGI). - 1 - haze in "information lost" areas will have the less bright color among the two, initial color and haze color with SSHGI correction. | **Arguments:** **[0.0f; 1.0f]** - available range **0.95f** - by default | | render_environment_haze_dither_scale | | | **Description:** - **Variable.** � Prints the current dithering intensity for haze rendering. Dithering adds subtle noise to reduce color banding in haze gradients. - **Command.** � Sets the dithering intensity for haze rendering. Dithering adds subtle noise to reduce color banding in haze gradients. | **Arguments:** **[0.0f; 1.0f]** - available range **0.0f** - by default | | render_lightmap_color | | | **Description:** - **Variable.** � Prints the current color multiplier for lightmaps. - **Command.** � Sets the color multiplier for lightmaps. > **Notice:** Some light sources may be modified after the lightmap was baked. To make lighting in the scene consistent once again without any re-baking you can simply adjust the color multiplier for lightmaps. See the [How-To video tutorial](../../videotutorials/how_to/how_to_rendering/lightmap_color.md) for additional information. | **Arguments:** **vec4_one** - default value (white) | | render_lights_dither_scale | | | **Description:** - **Variable.** � Prints the current dithering intensity for light rendering. Dithering adds subtle noise to reduce color banding in light gradients. - **Command.** � Sets the dithering intensity for light rendering. Dithering adds subtle noise to reduce color banding in light gradients. | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_lights_forward_per_object_world | | | **Description:** - **Variable.** � Prints the current maximum number of World lights per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). - **Command.** � Sets the maximum number of World lights per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). You should set the nonzero value to increase performance: it is not recommended to use more than 4 World lights per object. | **Arguments:** **[0; 128]** - available range **4** - by default | | render_lights_forward_per_object_omni | | | **Description:** - **Variable.** � Prints the current maximum number of Omni lights per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). - **Command.** � Sets the maximum number of Omni lights per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Omni lights per object. | **Arguments:** **[0; 128]** - available range **4** - by default | | render_lights_forward_per_object_proj | | | **Description:** - **Variable.** � Prints the current maximum number of Projected lights per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). - **Command.** � Sets the maximum number of Projected lights per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Projected lights per object. | **Arguments:** **[0; 128]** - available range **4** - by default | | render_lights_forward_per_object_env | | | **Description:** - **Variable.** � Prints the current maximum number of Environment Probes per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). - **Command.** � Sets the maximum number of Environment Probes per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Voxel Probes per object. | **Arguments:** **[0; 128]** - available range **4** - by default | | render_lights_forward_per_object_planar | | | **Description:** - **Variable.** � Prints the current maximum number of Planar Reflection Probes per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). - **Command.** � Sets the maximum number of Planar Reflection Probes per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Planar Reflection Probes per object. | **Arguments:** **[0; 128]** - available range **4** - by default | | render_lights_forward_per_object_voxel | | | **Description:** - **Variable.** � Prints the current maximum number of Voxel Probes per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). - **Command.** � Sets the maximum number of Voxel Probes per object (available only for materials rendered in the [forward rendering pass](../../principles/render/sequence/index.md#transparent)). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Voxel Probes per object. | **Arguments:** **[0; 128]** - available range **4** - by default | | render_lights_lens_flares | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of [per-light lens flares](../../api/library/lights/class.light_cpp.md#setLensFlaresEnabled_int_void) is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_direct_lighting_interleaved | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if interleaved mode for rendering direct lighting is enabled. When enabled, lights are rendered in half resolution with subsequent reconstruction of neighboring pixels using the data from previous frames. This mode requires a high framerate (60+ FPS), otherwise anti-aliasing quality reduces and ghosting effect becomes more pronounced. Recommended for relatively static scenes which contain a lot of light sources and do not have a lot of reflective surfaces (in case of small number of light sources may reduce performance). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_direct_lighting_interleaved_catmull_resampling | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the Catmull-Rom resampling for interleaved rendering of direct lighting is enabled. This mode allows you to reduce image blurring when the camera moves forward/backward. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_direct_lighting_interleaved_color_clamping | | | **Description:** - **Variable.** � Prints the current color clamping mode to be used for interleaved rendering of direct lighting. - **Command.** � Sets the color clamping mode to be used for interleaved rendering of direct lighting. This mode is used to reduce ghosting effect: higher values increase clamping intensity but may cause flickering on rippled reflective surfaces (as this mode is not so good at the object's edges). When disabled, shadows and reflections have a lag as they are several frames behind. | **Arguments:** **0** - Disabled **1** - Low (by default) **2** - Medium **3** - High **4** - High + Velocity | | render_direct_lighting_interleaved_samples | | | **Description:** - **Variable.** � Prints the current number of samples for interleaved rendering of direct lighting defining the number of pixels to be skipped during interleaved rendering of direct lighting with subsequent reconstruction of neighboring pixels using the data from previous frames (defines the size of reduced lights buffer relative to original size). - **Command.** � Sets the number of samples for interleaved rendering of direct lighting defining the number of pixels to be skipped during interleaved rendering of direct lighting with subsequent reconstruction of neighboring pixels using the data from previous frames (defines the size of reduced lights buffer relative to original size). - **1 x 2** - half of all pixels are rendered skipping each second line (1.0 * width x 0.5 * height) - **2 x 2** - quarter of all pixels are rendered skipping each second line and row (0.5 * width x 0.5 * height) | **Arguments:** **0** - 1 x 2 (by default) **1** - 2 x 2 | | render_indirect_lighting_interleaved | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if interleaved mode for rendering indirect lighting is enabled. When enabled, lights are rendered in half resolution with subsequent reconstruction of neighboring pixels using the data from previous frames. This mode requires a high framerate (60+ FPS), otherwise anti-aliasing quality reduces and ghosting effect becomes more pronounced. Recommended for relatively static scenes which contain a lot of light sources and do not have a lot of reflective surfaces (in case of small number of light sources may reduce performance). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_indirect_lighting_interleaved_color_clamping_intensity | | | **Description:** - **Variable.** � Prints the current constant size of the intensity of color clamping for interleaved indirect lighting. - **Command.** � Sets the constant size of the intensity of color clamping for interleaved indirect lighting. | **Arguments:** **[0.0f; 100.0f]** - available range **0.0f** - by default | | render_indirect_lighting_interleaved_color_clamping_velocity_threshold | | | **Description:** - **Variable.** � Prints the current velocity threshold of color clamping for interleaved indirect lighting. The higher the value, the less the ghosting effect. However, increasing the threshold may change the overall image brightness due to excessive color clamping. - **Command.** � Sets the velocity threshold of color clamping for interleaved indirect lighting. The higher the value, the less the ghosting effect. However, increasing the threshold may change the overall image brightness due to excessive color clamping. | **Arguments:** **[0.0f; 1000.0f]** - available range **100.0f** - by default | | render_indirect_lighting_interleaved_catmull_resampling | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether Catmull-Rom resampling is enabled or not. Catmull-Rom resampling allows you to reduce image blurring when the camera moves forward/backward. It is recommended to disable resampling for low quality presets. | **Arguments:** **0** - disabled **1** - enabled | | render_indirect_lighting_interleaved_color_clamping | | | **Description:** - **Variable.** � Prints the current color clamping mode to be used for interleaved rendering of indirect lighting. - **Command.** � Sets the color clamping mode to be used for interleaved rendering of indirect lighting. This mode is used to reduce ghosting effect: higher values increase clamping intensity but may cause flickering on rippled reflective surfaces (as this mode is not so good at the object's edges). When disabled, shadows and reflections have a lag as they are several frames behind. | **Arguments:** **0** - Disabled **1** - Low **2** - High (by default) | | render_indirect_lighting_interleaved_samples | | | **Description:** - **Variable.** � Prints the current number of samples for interleaved rendering of indirect lighting defining the number of pixels to be skipped during interleaved rendering of indirect lighting with subsequent reconstruction of neighboring pixels using the data from previous frames (defines the size of reduced lights buffer relative to original size). - **Command.** � Sets the number of samples for interleaved rendering of indirect lighting defining the number of pixels to be skipped during interleaved rendering of indirect lighting with subsequent reconstruction of neighboring pixels using the data from previous frames (defines the size of reduced lights buffer relative to original size). - **1 x 2** - half of all pixels are rendered skipping each second line (1.0 * width x 0.5 * height) - **2 x 2** - quarter of all pixels are rendered skipping each second line and row (0.5 * width x 0.5 * height) | **Arguments:** **0** - 1 x 2 **1** - 2 x 2 (by default) | | render_indirect_diffuse_denoise_threshold_ao | | | **Description:** - **Variable.** � Prints the current threshold of the noise reduction value for the indirect diffuse lighting in the areas where the Ambient Occlusion mask is black. - **Command.** � Sets the threshold of the noise reduction value for the indirect diffuse lighting in the areas where the Ambient Occlusion mask is black. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_indirect_diffuse_temporal_filtering_frames_clamping_velocity_threshold | | | **Description:** - **Variable.** � Prints the current threshold velocity value exceeding which the number of accumulated frames will be equal to Frame Count Min *[render_indirect_diffuse_temporal_filtering_frame_count_min](#render_indirect_diffuse_temporal_filtering_frame_count_min)*. - **Command.** � Sets the threshold velocity value exceeding which the number of accumulated frames will be equal to Frame Count Min *[render_indirect_diffuse_temporal_filtering_frame_count_min](#render_indirect_diffuse_temporal_filtering_frame_count_min)*. | **Arguments:** **[0.0f; inf]** - available range **10.0f** - by default | | render_indirect_diffuse_temporal_filtering_color_clamping_intensity_ao | | | **Description:** - **Variable.** � Prints the current intensity of temporal filtering color clamping at zero pixel velocity for Indirect Diffuse in the areas where the Ambient Occlusion mask is black (the Distance buffer). - **Command.** � Sets the intensity of temporal filtering color clamping at zero pixel velocity for Indirect Diffuse in the areas where the Ambient Occlusion mask is black (the Distance buffer). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_indirect_diffuse_temporal_filtering_frame_count_min | | | **Description:** - **Variable.** � Prints the current number of accumulated frames in the information lost areas and if the Frames Clamping Velocity value *[render_indirect_diffuse_temporal_filtering_frames_clamping_velocity_threshold](#render_indirect_diffuse_temporal_filtering_frames_clamping_velocity_threshold)* is exceeded. - **Command.** � Sets the number of accumulated frames in the information lost areas and if the Frames Clamping Velocity value *[render_indirect_diffuse_temporal_filtering_frames_clamping_velocity_threshold](#render_indirect_diffuse_temporal_filtering_frames_clamping_velocity_threshold)* is exceeded. | **Arguments:** **[0.0f; inf]** - available range **50.0f** - by default | | render_indirect_specular_denoise_threshold_ao | | | **Description:** - **Variable.** � Prints the current threshold noise reduction value for the indirect specular lighting in the areas where the Ambient Occlusion mask is black. - **Command.** � Sets the threshold noise reduction value for the indirect specular lighting in the areas where the Ambient Occlusion mask is black. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_indirect_specular_temporal_filtering_color_clamping_intensity_ao | | | **Description:** - **Variable.** � Prints the current intensity of temporal filtering color clamping at zero pixel velocity for Indirect Specular in the areas where the Ambient Occlusion mask is black (the Distance buffer). - **Command.** � Sets the intensity of temporal filtering color clamping at zero pixel velocity for Indirect Specular in the areas where the Ambient Occlusion mask is black (the Distance buffer). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_indirect_specular_temporal_filtering_frame_count_min | | | **Description:** - **Variable.** � Prints the current number of accumulated frames in the information lost areas and if the Frames Clamping Velocity value *[render_indirect_specular_temporal_filtering_frames_clamping_velocity_threshold](#render_indirect_specular_temporal_filtering_frames_clamping_velocity_threshold)* is exceeded. - **Command.** � Sets the number of accumulated frames in the information lost areas and if the Frames Clamping Velocity value *[render_indirect_specular_temporal_filtering_frames_clamping_velocity_threshold](#render_indirect_specular_temporal_filtering_frames_clamping_velocity_threshold)* is exceeded. | **Arguments:** **[0.0f; inf]** - available range **50.0f** - by default | | render_indirect_specular_temporal_filtering_frames_clamping_velocity_threshold | | | **Description:** - **Variable.** � Prints the current threshold velocity value exceeding which the number of accumulated frames will be equal to Frame Count Min *[render_indirect_specular_temporal_filtering_frame_count_min](#render_indirect_specular_temporal_filtering_frame_count_min)*. - **Command.** � Sets the threshold velocity value exceeding which the number of accumulated frames will be equal to Frame Count Min *[render_indirect_specular_temporal_filtering_frame_count_min](#render_indirect_specular_temporal_filtering_frame_count_min)*. | **Arguments:** **[0.0f; inf]** - available range **10.0f** - by default | | render_show_lighting_mode | | | **Description:** - **Variable.** � Prints the current visualization of surfaces with the selected lighting mode. - **Command.** � Sets the visualization of surfaces with the selected lighting mode. | **Arguments:** **0** - disabled (by default) **1** - render objects using static lighting mode **2** - render objects using dynamic lighting mode **3** - render objects using advanced lighting mode | | render_ssao | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [SSAO](../../editor2/settings/render_settings/global_illumination/indirect_diffuse/ssao/index.md) (Screen Space Ambient Occlusion) effect is enabled. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_gi_preset](/code/console/#render_gi_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ssao_cavity | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the cavity option for the SSAO (Screen Space Ambient Occlusion) effect is enabled. This option improves (sharpens) the look of junction contours at low resolutions, so it should be used for detail enhancement (small stones, bolts and so on). > **Notice:** When checking the parameter value via API, you'll get the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_ssao_cavity_intensity | | | **Description:** - **Variable.** � Prints the current intensity of sharpening of contours for the cavity option*[render_ssao_cavity](#render_ssao_cavity)*. - **Command.** � Sets the intensity of sharpening of contours for the cavity option*[render_ssao_cavity](#render_ssao_cavity)*. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssao_cavity_radius | | | **Description:** - **Variable.** � Prints the current size of junction contours area for the cavity option for the SSAO (Screen Space Ambient Occlusion) effect*[render_ssao_cavity](#render_ssao_cavity)*. - **Command.** � Sets the size of junction contours area for the cavity option for the SSAO (Screen Space Ambient Occlusion) effect*[render_ssao_cavity](#render_ssao_cavity)*. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssao_threshold | | | **Description:** - **Variable.** � Prints the current threshold value for the SSAO (Screen Space Ambient Occlusion) effect. - **Command.** � Sets the threshold value for the SSAO (Screen Space Ambient Occlusion) effect. It limits SSAO in areas where information cannot be obtained. The *higher* the value, the less pronounced the effect is. | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_ssao_intensity | | | **Description:** - **Variable.** � Prints the current [intensity](../../editor2/settings/render_settings/global_illumination/indirect_diffuse/ssao/index.md#ssao_intensity) of the SSAO (Screen Space Ambient Occlusion) for the scene. - **Command.** � Sets the [intensity](../../editor2/settings/render_settings/global_illumination/indirect_diffuse/ssao/index.md#ssao_intensity) of the SSAO (Screen Space Ambient Occlusion) for the scene. The intensity value affects brightness of shadows: by the minimum value of 0.0f, the ambient occlusion shadowing is the lightest. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_ssao_intensity_reflection | | | **Description:** - **Variable.** � Prints the current intensity of SSAO (Screen Space Ambient Occlusion) on reflections. - **Command.** � Sets the intensity of SSAO (Screen Space Ambient Occlusion) on reflections. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_gbuffer_lightmap | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if lightmap data is stored in the gbuffer. | **Arguments:** **0** - disabled **1** - enabled (by default) | #### Shadows Operations on shadows. | render_shadows | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether shadows are rendered. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_shadows_alpha_test | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if alpha test is enabled for shadows. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_shadows_screen_space | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if screen space shadows are enabled. They provide high-quality penumbra, per-light work, per-pixel detail at any zoom level and infinite visibility distance (when enabled, distant objects can cast shadows next to the horizon). Supports depth cutout parallax. Screen space shadows can be mixed with regular ones. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_shadows_translucent_depth | | | **Description:** - **Variable.** � Prints the current global translucence depth value defining how deep the light goes through translucent objects shifting the shadow. - **Command.** � Sets the global translucence depth value defining how deep the light goes through translucent objects shifting the shadow. The *higher* the value, the *deeper* the light penetrates translucent objects shifting the shadow. | **Arguments:** **[0.0f; inf]** - available range **0.1f** - by default | | render_shadow_distance | | | **Description:** - **Variable.** � Prints the current distance from the camera, beyond which shadows will not be rendered. - **Command.** � Sets the distance from the camera, beyond which shadows will not be rendered. > **Notice:** If this value is greater than the [visibility distance for objects](../../editor2/settings/render_settings/visibility_distances/index.md#objects_distance) the shadows will still be rendered even though the objects themselves are not. Please, pay attention to setting these parameters properly to avoid wasting performance on rendering unnecessary shadows. | **Arguments:** **[0.0f; inf]** - available range **100.0f** - by default | | render_shadow_distance_scale | | | **Description:** - **Variable.** � Prints the current global scale multiplier for [shadow distances](#render_shadow_distance). - **Command.** � Sets the global scale multiplier for [shadow distances](#render_shadow_distance). This option enables you to easily increase or decrease shadows rendering performance by changing the scale. > **Notice:** If this value is greater than the scale multiplier for objects*[render_distance_scale](#render_distance_scale)*, the shadows will still be rendered even though the objects themselves are not. Please, make sure you set these parameters properly to avoid wasting performance on rendering unnecessary shadows. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_screen_space_shadow_shafts_mode | | | **Description:** - **Variable.** � Prints the current rendering mode for volumetric [screen-space shadow shafts](../../editor2/settings/render_settings/environment/index.md#ssss). - **Command.** � Sets the rendering mode for volumetric [screen-space shadow shafts](../../editor2/settings/render_settings/environment/index.md#ssss). Shadow shafts (aka light shafts) can be generated in screen space for the Sun and the Moon to simulate the real world effect of crepuscular rays, or atmospheric shadowing of atmospheric in-scattering. These rays add depth and realism to any scene. > **Notice:** - This effect works for opaque geometry only. > - It is recommended to use Screen-Space Shadow Shafts with relatively thick haze for visual consistency. > - Disable this effect for indoor scenes as only world light sources are supported. | **Arguments:** **0** - Disabled **1** - Sun shadow shafts (by default) **2** - Moon shadow shafts **3** - Sun and Moon shadow shafts | | render_screen_space_shadow_shafts_length | | | **Description:** - **Variable.** � Prints the current length of volumetric [screen-space shadow shafts](../../editor2/settings/render_settings/environment/index.md#ssss). - **Command.** � Sets the length of volumetric [screen-space shadow shafts](../../editor2/settings/render_settings/environment/index.md#ssss). | **Arguments:** **[0.0f; 100.0f]** - available range **3.0f** - by default | | render_screen_space_shadow_shafts_quality | | | **Description:** - **Variable.** � Prints the current [quality](../../editor2/settings/render_settings/environment/index.md#ssss_quality) of screen-space shadow shafts. - **Command.** � Sets the [quality](../../editor2/settings/render_settings/environment/index.md#ssss_quality) of screen-space shadow shafts. Defines the number of steps to be used when generating the texture for this effect. *Lower* quality values may result in noticeable banding effect especially in case of long shadow shafts. *Medium* quality is usually enough, but you can increase it if shafts are long enough and banding effect becomes noticeable. | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_screen_space_shadow_shafts_resolution | | | **Description:** - **Variable.** � Prints the current [resolution of the texture](../../editor2/settings/render_settings/environment/index.md#ssss_resolution) to which screen-space shadows are rendered. - **Command.** � Sets the [resolution of the texture](../../editor2/settings/render_settings/environment/index.md#ssss_resolution) to which screen-space shadows are rendered. | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(1)** | | render_shadows_simplified | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the [static shadows](../../code/materials_shaders/abstract_materials/mesh.md#static_shadow) are enabled for all materials in the scene. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_shadows_reuse | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the shadow maps of the main viewport are reused for other viewports. Shadow maps are normally rendered separately for each viewport when multiple viewports render the scene. It is important as each camera that renders into the viewport has its unique transformation. However, in cases when cameras are close to each other, shadows appear very similar, so for certain viewport and camera configurations you can save resources by enabling this mode - the shadow maps will be rendered only for the main viewport and then used for the others. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_cascades | Config file: [*.user](../../code/configuration_file_cpp.md#user) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of Parallel Split Shadow Map - world shadow cascades. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_world_shadow_casters | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces that are configured to cast shadows from the current *World Light*. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_show_proj_and_omni_shadow_casters | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the [visualizer](../../api/library/engine/class.visualizer_cpp.md) is displayed for surfaces that are configured to cast shadows from *Proj* and *Omni* light sources. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_shadows_filter_mode | | | **Description:** - **Variable.** � Prints the current global filtering mode to be used for shadows from all light sources by default. - **Command.** � Sets the global filtering mode to be used for shadows from all light sources by default. This mode determines quality of soft shadows. *Higher* quality produces *smoother* shadow edges. When disabled, no filtering is performed and the stair-step effect is clearly seen at the edges of shadows. > **Notice:** You can set filtering mode or disable filtering for each light source [individually](../../api/library/lights/class.light_cpp.md#setShadowFilterMode_int_void). | **Arguments:** **0** - Disabled **1** - Low **2** - Medium (by default) **3** - High **4** - Ultra | | render_shadows_filter_noise | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if noise for shadow filtering is enabled. This noise is used for smoothing. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_shadows_penumbra_max_radius_omni | | | **Description:** - **Variable.** � Prints the current - **Variable.** Omni Light max penumbra width, in texels at the reference 4096 resolution. Higher = softer, wider; too low = hard shadows. - **Command.** � Sets the - **Variable.** Omni Light max penumbra width, in texels at the reference 4096 resolution. Higher = softer, wider; too low = hard shadows. | **Arguments:** **[0.0f; inf]** - available range **256.0f** - by default | | render_shadows_penumbra_max_radius_proj | | | **Description:** - **Variable.** � Prints the current - **Variable.** Proj Light max penumbra width, in texels at the reference 4096 resolution. Like the Omni ceiling; a projector foreshortens, so it may band at a smaller radius. - **Command.** � Sets the - **Variable.** Proj Light max penumbra width, in texels at the reference 4096 resolution. Like the Omni ceiling; a projector foreshortens, so it may band at a smaller radius. | **Arguments:** **[0.0f; inf]** - available range **256.0f** - by default | | render_shadows_penumbra_max_radius_world | | | **Description:** - **Variable.** � Prints the current - **Variable.** World Light max penumbra width, in texels at the reference 4096 resolution. Higher = softer, wider shadows (grainier, costlier search). - **Command.** � Sets the - **Variable.** World Light max penumbra width, in texels at the reference 4096 resolution. Higher = softer, wider shadows (grainier, costlier search). | **Arguments:** **[0.0f; inf]** - available range **16.0f** - by default | | render_shadows_penumbra_mode | | | **Description:** - **Variable.** � Prints the current global quality mode to be used for rendering penumbra from all light sources by default. - **Command.** � Sets the global quality mode to be used for rendering penumbra from all light sources by default. This mode enables simulation of real-world shadows by keeping sharp contact shadows closer to the base and softening the farther the shadow stretches away. *Higher* values produce *softer* shadows. When disabled, shadow edges are crisp and sharp (no shadow softness at all). > **Notice:** You can set penumbra quality mode or disable penumbra rendering for each light source [individually](../../api/library/lights/class.light_cpp.md#setShadowPenumbraMode_int_void). But these per-light quality settings are ignored when global quality is set to *Disabled*. | **Arguments:** **0** - Disabled **1** - Low (by default) **2** - Medium **3** - High **4** - Ultra | | render_shadows_penumbra_noise | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if noise for penumbra rendering is enabled. This noise is used for smoothing. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_shadows_world_lerp_cascades | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [linear interpolation of shadow cascades](../../editor2/settings/render_settings/shadows/index.md#lerp_shadow_cascades) is enabled, making transitions between cascades smoother. This option significantly affects performance, as two shadow maps are rendered in transition areas. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_shadows_world_cascades_culling_clusters | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether culling of shadow cascades is enabled for *Mesh Cluster/Clutter* objects. If enabled, the *Mesh Cluster/Clutter* objects rendered in the nearest cascade won't be rendered again in farther cascades. If disabled, the *Mesh Cluster* objects rendered in the nearest cascade will also be rendered in all other cascades. In some cases performance may be better if this option is disabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Geodetics Operations on geodetics. | render_show_geodetic_pivot | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether [geodetic pivots](../../objects/geodetics/geodeticpivot/index.md) are displayed. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### Clouds Rendering | render_clouds_quality_preset | | |---|---| | **Description:** - **Variable.** � Prints the current index of the clouds quality preset used at the moment. - **Command.** � Sets the index of the clouds quality preset used at the moment. | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High + Interleaved **3** - High **4** - Ultra + Interleaved **5** - Ultra **6** - Extreme + Interleaved **7** - Extreme **8** - Custom | | render_clouds_mode | | | **Description:** - **Variable.** � Prints the current clouds rendering mode. - **Command.** � Sets the clouds rendering mode. Rendering clouds into the panorama cubemap texture once per frame automatically makes the clouds seen in simple default environment-based reflections making them look more natural for a reduced cost. However, rendering views from inside the clouds is possible in *Volumetric* mode only. | **Arguments:** **0** - *Volumetric* - render volumetric clouds (by default) **1** - *Render To Panorama* - render clouds to panorama (environment cubemap) | | render_clouds_panorama_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the panorama cubemap texture. - **Command.** � Sets the resolution of the panorama cubemap texture. Available for *Render To Panorama* [clouds mode](#render_clouds_mode). | **Arguments:** **0** - 128x128 **1** - 256x256 **2** - 384x384 **3** - 512x512 **4** - 768x768 (by default) **5** - 1024x1024 **6** - 1536x1536 **7** - 2048x2048 **8** - 4096x4096 | | render_clouds_panorama_reuse | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the panorama cubemap texture is reused between several viewports. Available for *Render To Panorama* [clouds mode](#render_clouds_mode). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_clouds_accurate_layers_sorting | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if correct sorting of intersecting cloud layers is enabled. > **Notice:** Enabling this feature may reduce raymarching quality as samples shall be distributed among all layers. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_clouds_async_compute | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � - **Variable.** Render clouds using async compute queue (consoles only, requires render to panorama mode). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_clouds_depth_based_reconstruction | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if clouds ray-marched depth is used for upsampling the downsampled clouds without obscuring the geometry and reprojection depending on the cloud depth. Recommended for flying through clouds. > **Notice:** Works only with the clouds downsampling rendering mode*[render_clouds_downsampling_rendering](#render_clouds_downsampling_rendering)* set to half and/or the clouds interleaved rendering mode*[render_clouds_interleaved_rendering](#render_clouds_interleaved_rendering)* set to 2x2. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_clouds_depth_based_reconstruction_threshold | | | **Description:** - **Variable.** � Prints the current depth threshold value for clouds depth-based reconstruction mode*[render_clouds_depth_based_reconstruction](#render_clouds_depth_based_reconstruction)*. - **Command.** � Sets the depth threshold value for clouds depth-based reconstruction mode*[render_clouds_depth_based_reconstruction](#render_clouds_depth_based_reconstruction)*. This value defines the depth difference starting from which pixels are considered to be related to different surfaces. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; inf]** - available range **100.0f** - by default | | render_clouds_distortion_texture | | | **Description:** - **Variable.** � Prints the current value indicating which texture type is used for clouds distortion at the moment. - **Command.** � Sets the value indicating which texture type is used for clouds distortion at the moment. This parameter has a significant impact on performance: - **2D Texture** - more performance-friendly, but may cause an excessive vertical extrusion of clouds. - **3D Texture** - ensures homogeneous detail distortion and better image quality, but at a higher performance cost. | **Arguments:** **0** - 2D texture (by default) **1** - 3D texture | | render_clouds_downsampling_rendering | | | **Description:** - **Variable.** � Prints the current downsampling rendering mode for clouds. - **Command.** � Sets the downsampling rendering mode for clouds. This parameter determines clouds resolution based on current screen resolution. > **Notice:** This parameter has a significant impact on performance. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - quarter resolution - **1** - half resolution - **2** - full resolution The default value is **(1)** | | render_clouds_dynamic_coverage_area | | | **Description:** - **Variable.** � Prints the current dynamic coverage area for clouds, in units. - **Command.** � Sets the dynamic coverage area for clouds, in units. This parameter determines visibility distance for coverage of [FieldWeather](../../objects/effects/fields/field_weather/index.md) objects. > **Notice:** Increasing dynamic coverage area leads to reduction of quality of FieldWeather coverage texture and loss of details. This effect can be mitigated by increasing dynamic coverage resolution using the corresponding command*[render_clouds_dynamic_coverage_resolution](#render_clouds_dynamic_coverage_resolution)*. | **Arguments:** **[10.0f; 400000.0f]** - available range **10000.0f** - by default | | render_clouds_dynamic_coverage_resolution | | | **Description:** - **Variable.** � Prints the current the value defining the size of the square dynamic coverage resolution texture for clouds, in pixels. - **Command.** � Sets the the value defining the size of the square dynamic coverage resolution texture for clouds, in pixels. This parameter determines the quality of dynamic coverage texture for [FieldWeather](../../objects/effects/fields/field_weather/index.md) objects. Higher values make it possible to preserve texture details at high distances. > **Notice:** Increased resolution significantly affects performance. | **Arguments:** **[16; 8192]** - available range **256** - by default | | render_clouds_environment_color | | | **Description:** - **Variable.** � Prints the current color multiplier for the custom environment cubemap texture specified via [CloudsEnvironmentTexturePath](#CloudsEnvironmentTexturePath). Only applies in Panorama clouds rendering mode. - **Command.** � Sets the color multiplier for the custom environment cubemap texture specified via [CloudsEnvironmentTexturePath](#CloudsEnvironmentTexturePath). Only applies in Panorama clouds rendering mode. | **Arguments:** **vec4(1.0f, 1.0f, 1.0f, 1.0f)** - default value (white) | | render_clouds_environment_sky | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether the custom environment cubemap texture is automatically adjusted to match the current sky lighting. When enabled, the original sky color baked into the texture (specified via [CloudsEnvironmentSkyColor](#CloudsEnvironmentSkyColor)) is replaced with the actual sky color based on the current sun position. Only applies in Panorama clouds rendering mode. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_clouds_environment_sky_color | | | **Description:** - **Variable.** � Prints the current reference sky color that was baked into the custom environment cubemap texture. Used to remove the original sky lighting before applying the current sky color when [CloudsEnvironmentSky](#CloudsEnvironmentSky) is enabled. Only applies in Panorama clouds rendering mode. - **Command.** � Sets the reference sky color that was baked into the custom environment cubemap texture. Used to remove the original sky lighting before applying the current sky color when [CloudsEnvironmentSky](#CloudsEnvironmentSky) is enabled. Only applies in Panorama clouds rendering mode. | **Arguments:** **vec4(1.0f, 1.0f, 1.0f, 1.0f)** - default value (white) | | render_clouds_far_clipping | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [far-plane clipping](../../editor2/camera_settings/index.md#camera_settings) is used for clouds visibility. Controlling clouds visibility by increasing the far-plane distance significantly affects performance in many aspects (dynamic Environment Probes, etc.). You can disable this option when necessary as an optimization. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_clouds_ground_shadows | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of shadows from the clouds on the ground is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_clouds_3d_texture_horizontal_resolution | | | **Description:** - **Variable.** � Prints the current horizontal resolution for the 3D texture to be used for clouds rendering. - **Command.** � Sets the horizontal resolution for the 3D texture to be used for clouds rendering. > **Notice:** Setting too high resolution may significantly affect performance, so adjust it wisely. | **Arguments:** **0** - 64 **1** - 128 **2** - 256 (by default) **3** - 512 **4** - 1024 **5** - 2048 | | render_clouds_3d_texture_vertical_resolution | | | **Description:** - **Variable.** � Prints the current vertical resolution for the 3D texture to be used for clouds rendering. - **Command.** � Sets the vertical resolution for the 3D texture to be used for clouds rendering. > **Notice:** Setting too high resolution may significantly affect performance, so adjust it wisely. | **Arguments:** **0** - 32 **1** - 64 **2** - 128 **3** - 256 (by default) **4** - 512 | | render_clouds_interleaved_rendering | | | **Description:** - **Variable.** � Prints the current [interleaved rendering mode](../../editor2/settings/render_settings/clouds/index.md#interleaved_rendering) for clouds. - **Command.** � Sets the [interleaved rendering mode](../../editor2/settings/render_settings/clouds/index.md#interleaved_rendering) for clouds. In cases when clouds are viewed from the ground, or from above (at significant distance) and viewer's velocities are less than 200 units per second, this parameter can be used to provide a significant gain in performance. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - Disabled (by default) **1** - 2�2 **2** - 4�4 **3** - 8�8 | | render_clouds_interleaved_rendering_temporal | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if temporal accumulation of noises for interleaved sampling for clouds is enabled. > **Notice:** Works only when the clouds interleaved rendering mode*[render_clouds_interleaved_rendering](#render_clouds_interleaved_rendering)* is set to 2x2. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_clouds_lighting_cone_radius | | | **Description:** - **Variable.** � Prints the current [lighting cone sampling radius](../../editor2/settings/render_settings/clouds/index.md#lighting_cone_radius) for clouds lighting. - **Command.** � Sets the [lighting cone sampling radius](../../editor2/settings/render_settings/clouds/index.md#lighting_cone_radius) for clouds lighting. > **Notice:** Low values may result in unnatural behavior as the position of the sun changes. | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_clouds_lighting_quality | | | **Description:** - **Variable.** � Prints the current [lighting quality](../../editor2/settings/render_settings/clouds/index.md#lighting_quality) for clouds. - **Command.** � Sets the [lighting quality](../../editor2/settings/render_settings/clouds/index.md#lighting_quality) for clouds. This parameter determines the number of samples used to calculate lighting for clouds. The following values are available: > **Notice:** This parameter has a significant impact on performance. Therefore, it is recommended to use low settings, when possible. - **Low** - 1 sample, low quality - **Medium** - 3 samples, medium quality - **High** - 5 samples, high quality - **Ultra** - 6 samples, ultra quality > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_clouds_lighting_samples_distribution | | | **Description:** - **Variable.** � Prints the current value that controls distribution of samples for clouds lighting. - **Command.** � Sets the value that controls distribution of samples for clouds lighting. Can be used to keep small details for long shadows when the lighting trace length value*[render_clouds_lighting_tracelength](#render_clouds_lighting_tracelength)* is high. | **Arguments:** **[0.001f; 5.0f]** - available range **1.0f** - by default | | render_clouds_lighting_tracelength | | | **Description:** - **Variable.** � Prints the current [lighting trace length](../../editor2/settings/render_settings/clouds/index.md#lighting_trace_length) for clouds. - **Command.** � Sets the [lighting trace length](../../editor2/settings/render_settings/clouds/index.md#lighting_trace_length) for clouds. This parameter determines the maximum length of a sun ray inside a cloud. | **Arguments:** **[1.0f; 2048.0f]** - available range **230.0f** - by default | | render_clouds_noise_step | | | **Description:** - **Variable.** � Prints the current value of the *noise step* parameter for clouds. - **Command.** � Sets the value of the *noise step* parameter for clouds. This parameter determines the amount of jitter in the areas within clouds, that is used to reduce banding effect due to insufficient number of steps. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_clouds_noise_step_skip | | | **Description:** - **Variable.** � Prints the current value of the *noise step skip* parameter for clouds. - **Command.** � Sets the value of the *noise step skip* parameter for clouds. This parameter determines the amount of jitter in the areas between clouds, that is used to reduce banding effect due to insufficient number of steps. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_clouds_noise_iterations | | | **Description:** - **Variable.** � Prints the current value of the *noise iterations* parameter for clouds. - **Command.** � Sets the value of the *noise iterations* parameter for clouds. This parameter determines the amount of jitter in the areas within clouds, that is used to reduce banding effect due to insufficient number of steps. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_clouds_noise_lighting | | | **Description:** - **Variable.** � Prints the current value of the *noise lighting* parameter for the clouds. - **Command.** � Sets the value of the *noise lighting* parameter for the clouds. This parameter determines the amount of jitter for tracing steps of lighting calculation, that is used to reduce banding effect due to insufficient number of steps. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_clouds_rounded | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if cloud layers are to be curved to make them look more natural imitating planet's curvature. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_clouds_rounded_planet_radius | | | **Description:** - **Variable.** � Prints the current radius of the planet to be used for clouds curving. - **Command.** � Sets the radius of the planet to be used for clouds curving. Visual curving can be used to make clouds look more natural imitating planet's curvature. | **Arguments:** **[100.0f; inf]** - available range **200000.0f** - by default | | render_clouds_samples_count | | | **Description:** - **Variable.** � Prints the current [number of samples](../../editor2/settings/render_settings/clouds/index.md#samples_count) used for clouds rendering. - **Command.** � Sets the [number of samples](../../editor2/settings/render_settings/clouds/index.md#samples_count) used for clouds rendering. The higher the value, the less noise in clouds rendering. The following values are available: - **Low** - 1 sample, low quality - **Medium** - 3 samples, medium quality - **High** - 5 samples, high quality - **Ultra** - 6 samples, ultra quality > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(2)** | | render_clouds_sampling_quality | | | **Description:** - **Variable.** � Prints the current [sampling quality](../../editor2/settings/render_settings/clouds/index.md#sampling_quality) for clouds. - **Command.** � Sets the [sampling quality](../../editor2/settings/render_settings/clouds/index.md#sampling_quality) for clouds. This parameter sets the number of noise samples that affects the cloud shape processing quality. The higher the value, the less are visual artifacts. The following modes are available: > **Notice:** Visual difference between low and ultra quality is not significant. Therefore, it is recommended to use low settings, when possible, to gain performance. - **Low** - 1 sample, low quality (higher cloud density) - **Medium** - 3 samples, medium quality - **High** - 5 samples, high quality - **Ultra** - 6 samples, ultra quality (lower density, the clouds are softer) > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_clouds_soft_intersection | | | **Description:** - **Variable.** � Prints the current [soft intersection distance](../../editor2/settings/render_settings/clouds/index.md#soft_intersection) for clouds, in meters. - **Command.** � Sets the [soft intersection distance](../../editor2/settings/render_settings/clouds/index.md#soft_intersection) for clouds, in meters. | **Arguments:** **[0.0f; 100000.0f]** - available range **100.0f** - by default | | render_clouds_step_accuracy | | | **Description:** - **Variable.** � Prints the current accuracy of ray marching steps. - **Command.** � Sets the accuracy of ray marching steps. This parameter enables you to improve the visual look of clouds when viewed from inside a cloud layer. It reduces the noise of lighting and clouds shape for long ray marching distances, adds some noise-based blur to a sharp border at the bottom sphere of the cloud layer (rounded) and removes popping effect when leaving a rounded cloud layer. *Higher* values provide more accurate form and less noise, while *lower* ones gain more performance. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_clouds_quality_preset](/code/console/#render_clouds_quality_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_clouds_transparent_order | | | **Description:** - **Variable.** � Prints the current rendering order for clouds relative to transparent objects (except water). - **Command.** � Sets the rendering order for clouds relative to transparent objects (except water). - **Render Before Transparent** - render clouds before all [transparent objects](../../principles/render/sequence/index.md#transparent) (except water). - **Render After Transparent** - render clouds after all [transparent objects](../../principles/render/sequence/index.md#transparent) (except water). - **Sort Transparent** - enable rough sorting for [transparent objects](../../principles/render/sequence/index.md#transparent) relative to clouds (*below the lowest cloud layer base -> inside the clouds -> above the highest cloud layer top*). | **Arguments:** **0** - Render Before Transparent (by default) **1** - Render After Transparent **2** - Sort Transparent | | render_clouds_shaders_compile_mode | | | **Description:** - **Variable.** � Prints the current compilation mode for cloud shaders. - **Command.** � Sets the compilation mode for cloud shaders. | **Arguments:** **0** - Asynchronous cloud shader compiling (requires *[render_shaders_compile_mode](#render_shaders_compile_mode)* to be 0). (by default) **1** - Forced cloud shader compiling. | ### Terrain Rendering The commands described below are intended for configuring Landscape Terrain object (the *[ObjectLandscapeTerrain](../../api/library/objects/landscape_terrain/class.objectlandscapeterrain_cpp.md)* class). > **Warning:** Changing some of the parameters below [triggers reloading](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe) of the Landscape Terrain graphic data, so it's not recommended to do it at run time. | render_landscape_cache_cpu_size | | |---|---| | **Description:** - **Variable.** � Prints the current CPU cache size to be used for landscape terrain rendering, in percentage of the total memory. - **Command.** � Sets the CPU cache size to be used for landscape terrain rendering, in percentage of the total memory. CPU cache size affects intersections, physics, streaming, etc. The size of CPU cache depends on the scene. | **Arguments:** **[1; 100]** - available range **10** - by default | | render_landscape_cache_cpu_prefetch_radius | | | **Description:** - **Variable.** � Prints the current radius within which heights data is pre-loaded into memory for correct calculation of collisions and intersections. - **Command.** � Sets the radius within which heights data is pre-loaded into memory for correct calculation of collisions and intersections. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_landscape_cache_gpu_size | | | **Description:** - **Variable.** � Prints the current GPU cache size to be used for landscape terrain rendering, in percentage of the total GPU memory. - **Command.** � Sets the GPU cache size to be used for landscape terrain rendering, in percentage of the total GPU memory. GPU cache is used to accumulate tiles, that are visible to the camera, before streaming them to the megatexture. > **Notice:** High-resolution maps require larger cache capacity. | **Arguments:** **[1; 100]** - available range **4** - by default | | render_landscape_cache_gpu_life_time | | | **Description:** - **Variable.** � Prints the current lifetime of GPU cache used for Landscape Terrain rendering, in frames. - **Command.** � Sets the lifetime of GPU cache used for Landscape Terrain rendering, in frames. | **Arguments:** **[1; 60]** - available range **4** - by default | | render_landscape_operations_per_frame | | | **Description:** - **Variable.** � Prints the current maximum number of Landscape texture draw operations (*[asyncTextureDraw](../../api/library/objects/landscape_terrain/class.landscape.md#asyncTextureDraw_int_UGUID_ivec2_ivec2_int_VECWorldBoundBox_void)*) that can be performed per frame. - **Command.** � Sets the maximum number of Landscape texture draw operations (*[asyncTextureDraw](../../api/library/objects/landscape_terrain/class.landscape.md#asyncTextureDraw_int_UGUID_ivec2_ivec2_int_VECWorldBoundBox_void)*) that can be performed per frame. | **Arguments:** **[1; 1000]** - available range **10** - by default | | render_landscape_terrain_culling_frustum_aggressive | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if frustum culling optimization is enabled for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). When enabled, the number of culled polygons increases thereby increasing performance. In case of any issues with polygons rendering, try disabling this option (however, note that performance may drop). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_landscape_terrain_culling_by_depth | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if culling by depth is enabled. Keep this option enabled to get the performance higher due to culling of tiles occluded by geometry and Landscape Terrain itself. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_landscape_terrain_culling_depth_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the buffer used for culling by depth. - **Command.** � Sets the resolution of the buffer used for culling by depth. | **Arguments:** **[4; 2048]** - available range **64** - by default | | render_landscape_terrain_culling_padding_triangles | | | **Description:** - **Variable.** � Prints the current padding between LODs of tessellated polygons. - **Command.** � Sets the padding between LODs of tessellated polygons. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_landscape_terrain_culling_padding_patch_gpu | | | **Description:** - **Variable.** � Prints the current padding between LODs of patches culled on GPU. - **Command.** � Sets the padding between LODs of patches culled on GPU. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_landscape_terrain_culling_padding_patch_cpu | | | **Description:** - **Variable.** � Prints the current padding between LODs of patches culled on CPU. - **Command.** � Sets the padding between LODs of patches culled on CPU. | **Arguments:** **[0.0f; inf]** - available range **1.0f** - by default | | render_landscape_terrain_culling_patch_batching | | | **Description:** - **Variable.** � Prints the current number of culling patches of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) processed in a batch. - **Command.** � Sets the number of culling patches of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) processed in a batch. The higher this value, the more patches will be checked for visibility on CPU at once. | **Arguments:** **[1; 64]** - available range **16** - by default | | render_landscape_terrain_culling_patch_resolution_gpu | | | **Description:** - **Variable.** � Prints the current number of subdivisions for patches of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) culled on the GPU side that are to be tessellated. - **Command.** � Sets the number of subdivisions for patches of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) culled on the GPU side that are to be tessellated. By lowering this value you reduce the load on CPU, by increasing it you reduce the load on GPU. The point is to find a trade-off between loads in the given conditions on the target hardware. | **Arguments:** **[4; 64]** - available range **32** - by default | | render_landscape_terrain_culling_patch_resolution_cpu | | | **Description:** - **Variable.** � Prints the current number of subdivisions for patches of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) culled on the CPU side that are to be passed to GPU. - **Command.** � Sets the number of subdivisions for patches of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) culled on the CPU side that are to be passed to GPU. The lowest value of 2 corresponds to no subdivisions at all, i.e. all patched will be culled on the CPU side. By increasing this value you can reduce the load on CPU as more patches will be checked for visibility on the GPU side. | **Arguments:** **[2; 64]** - available range **2** - by default | | render_landscape_terrain_culling_oblique_frustum | | | **Description:** - **Variable.** � Prints the current multiplier for culling of tessellation patches of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) beyond the oblique frustum plane. - **Command.** � Sets the multiplier for culling of tessellation patches of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) beyond the oblique frustum plane. *Higher* values result in more patches culled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.9f** - by default | | render_landscape_terrain_culling_map | | | **Description:** - **Variable.** � Prints the current extent of culling of [Landscape Layer Maps](../../objects/objects/terrain/landscape_terrain/landscape_layer_map.md) with the distance. - **Command.** � Sets the extent of culling of [Landscape Layer Maps](../../objects/objects/terrain/landscape_terrain/landscape_layer_map.md) with the distance. In case small Landscape Layer Maps disappear too soon with the distance, try increasing this value. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **[0.0f; 1.0f]** - available range **0.3f** - by default | | render_landscape_terrain_detail_compression | | | **Description:** - **Variable.** � Prints the current mode of detail textures compression. - **Command.** � Sets the mode of detail textures compression. Compressed detail textures take less video memory. | **Arguments:** **0** - Disabled **1** - Fast Compression (by default) **2** - High Quality | | render_landscape_terrain_detail_resolution_additional_mask | | | **Description:** - **Variable.** � Prints the current resolution of the additional mask texture for details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). - **Command.** � Sets the resolution of the additional mask texture for details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **0** - 64�64 **1** - 128�128 **2** - 256�256 **3** - 512�512 **4** - 1024�1024 (by default) **5** - 2048�2048 **6** - 4096�4096 **7** - 8192�8192 **8** - 16384�16384 | | render_landscape_terrain_detail_resolution_albedo | | | **Description:** - **Variable.** � Prints the current resolution of the albedo texture for details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). - **Command.** � Sets the resolution of the albedo texture for details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **0** - 64�64 **1** - 128�128 **2** - 256�256 **3** - 512�512 **4** - 1024�1024 (by default) **5** - 2048�2048 **6** - 4096�4096 **7** - 8192�8192 **8** - 16384�16384 | | render_landscape_terrain_detail_resolution_height | | | **Description:** - **Variable.** � Prints the current resolution of the height texture for details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). - **Command.** � Sets the resolution of the height texture for details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **0** - 64�64 **1** - 128�128 **2** - 256�256 **3** - 512�512 **4** - 1024�1024 (by default) **5** - 2048�2048 **6** - 4096�4096 **7** - 8192�8192 **8** - 16384�16384 | | render_landscape_terrain_mask_dithering | | | **Description:** - **Variable.** � Prints the current global dither amount multiplier to be used for rendering details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). - **Command.** � Sets the global dither amount multiplier to be used for rendering details of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md). Dithering enables reduction of graphical artefacts in case of increased Mask Contrast values set for a detail. This is a global multiplier for dithering values set [for each detail mask](../../api/library/objects/landscape_terrain/class.terraindetailmask.md#setDithering_float_void). > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **[0.0f; 1.0f]** - available range **1.0f** - by default | | render_landscape_terrain_geometry_detail_max_height | | | **Description:** - **Variable.** � Prints the current maximum height for detail displacement clamping. - **Command.** � Sets the maximum height for detail displacement clamping. Adjust this value to the highest height value used in details in case of artifacts of stepped geometry caused by insufficient bit depth. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **[0.0f; 10.0f]** - available range **0.5f** - by default | | render_landscape_terrain_geometry_holes | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [decal-based holes](../../objects/objects/terrain/landscape_terrain/index.md#decal_holes) for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) are enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_landscape_terrain_geometry_polygon_size | | | **Description:** - **Variable.** � Prints the current size of Landscape Terrain polygons defining the maximum allowed density of Landscape Terrain geometry. - **Command.** � Sets the size of Landscape Terrain polygons defining the maximum allowed density of Landscape Terrain geometry. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_geometry_preset](/code/console/#render_landscape_terrain_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1000.0f]** - available range **0.01f** - by default | | render_landscape_terrain_geometry_progression | | | **Description:** - **Variable.** � Prints the current progression of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) geometry tessellation. - **Command.** � Sets the progression of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) geometry tessellation. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_geometry_preset](/code/console/#render_landscape_terrain_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 50.0f]** - available range **1.5f** - by default | | render_landscape_terrain_geometry_subpixel_reduction | | | **Description:** - **Variable.** � Prints the current minimum ratio between the polygon size (in screen space) to the size of an area in the viewport for [skipping polygons rendering](../../objects/objects/terrain/landscape_terrain/settings.md#subpixel_reduction) (the ones having a lower ratio will be removed). - **Command.** � Sets the minimum ratio between the polygon size (in screen space) to the size of an area in the viewport for [skipping polygons rendering](../../objects/objects/terrain/landscape_terrain/settings.md#subpixel_reduction) (the ones having a lower ratio will be removed). > **Notice:** Setting too high values may cause small but noticeable visual artifacts when the camera moves. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_geometry_preset](/code/console/#render_landscape_terrain_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 50.0f]** - available range **6.0f** - by default | | render_landscape_terrain_geometry_preset | | | **Description:** - **Variable.** � Prints the current index of the Landscape Terrain geometry preset used at the moment. - **Command.** � Sets the index of the Landscape Terrain geometry preset used at the moment. > **Notice:** Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via [API](../../api/library/rendering/class.render_cpp.md) has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API you'll get the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High **3** - Ultra **4** - Extreme **5** - Custom | | render_landscape_terrain_streaming_preset | | | **Description:** - **Variable.** � Prints the current index of the Landscape Terrain streaming preset used at the moment. - **Command.** � Sets the index of the Landscape Terrain streaming preset used at the moment. > **Notice:** Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via [API](../../api/library/rendering/class.render_cpp.md) has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API you'll get the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High **3** - Ultra **4** - Extreme **5** - Custom | | render_landscape_terrain_streaming_threads | | | **Description:** - **Variable.** � Prints the current number of threads used for streaming. - **Command.** � Sets the number of threads used for streaming. | **Arguments:** **[0; 32]** - available range **1** - by default | | render_landscape_terrain_streaming_per_lods | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if streaming per LODs (MIP maps) is enabled. Disable this option to make streaming faster by skipping loading of intermediate MIP-levels for textures. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_landscape_terrain_texel_size | | | **Description:** - **Variable.** � Prints the current texel size of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) render textures representing the maximum level of detail for the albedo, normal, and height components of the Landscape Terrain. - **Command.** � Sets the texel size of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) render textures representing the maximum level of detail for the albedo, normal, and height components of the Landscape Terrain. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0001f; 1.0f]** - available range **0.001f** - by default | | render_landscape_terrain_visible_distance | | | **Description:** - **Variable.** � Prints the current maximum visibility distance for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md), in meters. - **Command.** � Sets the maximum visibility distance for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md), in meters. The terrain is visible, as long as the distance between the camera and the terrain does not exceed this value. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **[0.0f; inf]** - available range **30000.0f** - by default | | render_landscape_terrain_vt_detail_level_by_angle | | | **Description:** - **Variable.** � Prints the current value indicating detail level reduction depending on the inclination of the the Landscape Terrain polygons relative to viewing direction. - **Command.** � Sets the value indicating detail level reduction depending on the inclination of the the Landscape Terrain polygons relative to viewing direction. Can be used to reduce streaming load and memory consumption. The value of 1 corresponds to the pixel-to-pixel quality, and lower values decrease it. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.95f** - by default | | render_landscape_terrain_vt_filtering | | | **Description:** - **Variable.** � Prints the current filtering mode for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) textures. - **Command.** � Sets the filtering mode for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) textures. The following values are available: - Low - use the lower mip-level - Medium - use the higher mip-level - High - linearly interpolate between adjacent mip-levels > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **0** - Low **1** - Medium (by default) **2** - High | | render_landscape_terrain_vt_hash_size | | | **Description:** - **Variable.** � Prints the current upper limit for the hash function used to determine tiles of *Landscape Terrain*. - **Command.** � Sets the upper limit for the hash function used to determine tiles of *Landscape Terrain*. The value must be high enough to cover all variety of world-space positions of tiles being used and streamed. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **[1000; 5000000]** - available range **1000000** - by default | | render_landscape_terrain_vt_hash_number_mistakes | | | **Description:** - **Variable.** � Prints the current number of mistakes of the hash function used in *Landscape Terrain* data streaming. - **Command.** � Sets the number of mistakes of the hash function used in *Landscape Terrain* data streaming. This value actually represents the number of iterations to compute a new unique hash value that determines a tile being streamed. Too low values may introduce collisions and, therefore, wrong terrain data at certain areas. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **[1; 32]** - available range **2** - by default | | render_landscape_terrain_vt_memory_size | | | **Description:** - **Variable.** � Prints the current value defining memory consumption for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) textures. - **Command.** � Sets the value defining memory consumption for the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) textures. The value is interpreted as follows: > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). - 0.0f - 3072�3072 (~200 MB of VRAM) - 1.0f - 16384�16384 (~3.1 GB of VRAM) - **0.4f** - 8192�8192 (~860 MB of VRAM) > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.4f** - by default | | render_landscape_terrain_vt_target_resolution | | | **Description:** - **Variable.** � Prints the current [target resolution](../../objects/objects/terrain/landscape_terrain/settings.md#target_resolution) (width x height) for the Landscape Terrain, in pixels. - **Command.** � Sets the [target resolution](../../objects/objects/terrain/landscape_terrain/settings.md#target_resolution) (width x height) for the Landscape Terrain, in pixels. | **Arguments:** **1344 х 756** - (default) | | render_landscape_terrain_vt_sampler_feedback_screen_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the screen buffer used to detect visible tiles and what MIP-levels to be loaded. - **Command.** � Sets the resolution of the screen buffer used to detect visible tiles and what MIP-levels to be loaded. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** **0** - Quarter **1** - Half (by default) **2** - Full | | render_landscape_terrain_vt_sampler_feedback_buffer_resolution | | | **Description:** - **Variable.** � Prints the current resolution of the buffer used to transfer data about tiles and what MIP-levels to be loaded. - **Command.** � Sets the resolution of the buffer used to transfer data about tiles and what MIP-levels to be loaded. > **Notice:** [Reloads Landscape Terrain graphic data](../../objects/objects/terrain/landscape_terrain/settings.md#runtime_safe). | **Arguments:** From **1x1** to **1024x1024** Default: **80x60** | | render_landscape_terrain_vt_tiles_load_per_frame | | | **Description:** - **Variable.** � Prints the current number of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) tiles loaded per frame. - **Command.** � Sets the number of [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) tiles loaded per frame. You can decrease the value of this parameter to reduce spikes, but in this case streaming becomes slower and more noticeable. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 64]** - available range **4** - by default | | render_landscape_terrain_vt_tiles_reload_per_frame | | | **Description:** - **Variable.** � Prints the current number of tiles to be reloaded per frame after applying changes to the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) surface. - **Command.** � Sets the number of tiles to be reloaded per frame after applying changes to the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) surface. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 64]** - available range **4** - by default | | render_landscape_terrain_vt_tiles_update_per_frame | | | **Description:** - **Variable.** � Prints the current number of tiles passed to the virtual texture of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) each frame. - **Command.** � Sets the number of tiles passed to the virtual texture of the [Landscape Terrain](../../objects/objects/terrain/landscape_terrain/index.md) each frame. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_landscape_terrain_streaming_preset](/code/console/#render_landscape_terrain_streaming_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[1; 256]** - available range **60** - by default | > **Notice:** The commands described below affect only terrain (the *[ObjectTerrainGlobal](../../api/library/objects/class.objectterrainglobal_cpp.md)* class). | render_terrain_global_anisotropy | | |---|---| | **Description:** - **Variable.** � Prints the current [global terrain](../../objects/objects/terrain/terrain_global/index.md) texture anisotropy level (degree of anisotropic filtering). - **Command.** � Sets the [global terrain](../../objects/objects/terrain/terrain_global/index.md) texture anisotropy level (degree of anisotropic filtering). Anisotropy for the global terrain has a huge impact for the performance if terrain has a lot of tiled detail materials as anisotropy filtering for the terrain is much slower than for the other objects. | **Arguments:** **0** - anisotropy level 1 **1** - anisotropy level 2 **2** - anisotropy level 4 (by default) **3** - anisotropy level 8 **4** - anisotropy level 16 | | render_terrain_global_displacement | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if displacement mapping is enabled for the [Global Terrain](../../objects/objects/terrain/terrain_global/index.md). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_terrain_global_displacement_normal | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if displacement mapping for the [Global Terrain](../../objects/objects/terrain/terrain_global/index.md) rendering uses normals. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_terrain_global_holes | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [decal-based holes](../../objects/objects/terrain/terrain_global/index.md#decal_holes) are enabled for the [global terrain](../../objects/objects/terrain/terrain_global/index.md). | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_terrain_global_triplanar | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if [triplanar texture mapping](../../objects/objects/terrain/terrain_global/details/index.md#triplanar) is enabled for the [Global Terrain](../../objects/objects/terrain/terrain_global/index.md). If disabled, planar UV-mapping is used. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### ObjectWaterGlobal Rendering > **Notice:** The commands described below affect only global water (the *[ObjectWater](../../api/library/objects/class.objectwaterglobal_cpp.md)* class). | render_water_anisotropy | | |---|---| | **Description:** - **Variable.** � Prints the current water texture anisotropy level. - **Command.** � Sets the water texture anisotropy level. The following values are available: - 1x - anisotropy level 1 - 2x - anisotropy level 2 - 4x - anisotropy level 4 - 8x - anisotropy level 8 - 16x - anisotropy level 16 | **Arguments:** **0** - 1x **1** - 2x (by default) **2** - 4x **3** - 8x **4** - 16x | | render_water_environment_probes | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of environment probes on the water surface is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_voxel_probes | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if voxel probes are enabled for water rendering. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_planar_probes | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of [Planar Reflection Probes](../../objects/lights/planar/index.md) on the water surface is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_lights | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of lights on the water surface is enabled. > **Notice:** The option doesn't affect the [World Light source](../../objects/lights/world/index.md). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_opacity_depth | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if depth data for water is written to the opacity buffer. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_refraction_quality | | | **Description:** - **Variable.** � Prints the current quality of water refraction. - **Command.** � Sets the quality of water refraction. | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(2)** | | render_water_ssr | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the SSR (Screen Space Reflections) effect is enabled for water. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_ssr_quality | | | **Description:** - **Variable.** � Prints the current resolution of water SSR (Screen Space Reflections). - **Command.** � Sets the resolution of water SSR (Screen Space Reflections). | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(1)** | | render_water_ssr_increased_accuracy | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if increased accuracy for the water SSR (Screen Space Reflections). This option reduces visual artifacts by increasing accuracy of the last step. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_water_shafts | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if rendering of underwater shafts is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_shoreline_wetness | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the wetness effect for objects near the shoreline is enabled. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_geometry_preset | | | **Description:** - **Variable.** � Prints the current index of the Global Water geometry preset used at the moment. To customize the Global Water geometry preset options at run time you should activate the **Custom** preset: - **Command.** � Sets the index of the Global Water geometry preset used at the moment. To customize the Global Water geometry preset options at run time you should activate the **Custom** preset: | **Arguments:** **0** - Low (by default) **1** - Medium **2** - High **3** - Ultra **4** - Extreme **5** - Custom | | render_water_visible_distance | | | **Description:** - **Variable.** � Prints the current maximum visibility distance for the [Global Water](../../objects/objects/water/water_object.md). - **Command.** � Sets the maximum visibility distance for the [Global Water](../../objects/objects/water/water_object.md). The water is visible, as long as the distance between the camera and the water object does not exceed this value. | **Arguments:** **[0.0f; inf]** - available range **30000.0f** - by default | | render_water_geometry_polygon_size | | | **Description:** - **Variable.** � Prints the current size of [Global Water](../../objects/objects/water/water_object.md) polygons. - **Command.** � Sets the size of [Global Water](../../objects/objects/water/water_object.md) polygons. The value defines the maximum allowed density of Global Water geometry. If the polygon size is large, small waves will be lost. It is better to set this parameter to about 1/3 or 1/4 of the smallest wavelength. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_water_geometry_preset](/code/console/#render_water_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1000.0f]** - available range **0.01f** - by default | | render_water_geometry_progression | | | **Description:** - **Variable.** � Prints the current progression of [Global Water](../../objects/objects/water/water_object.md) geometry tessellation. - **Command.** � Sets the progression of [Global Water](../../objects/objects/water/water_object.md) geometry tessellation. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_water_geometry_preset](/code/console/#render_water_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 50.0f]** - available range **1.5f** - by default | | render_water_geometry_progression_fov_min | | | **Description:** - **Variable.** � Prints the current minimum camera field of view value taken into account for tessellation of [Global Water](../../objects/objects/water/water_object.md) geometry, in degrees. - **Command.** � Sets the minimum camera field of view value taken into account for tessellation of [Global Water](../../objects/objects/water/water_object.md) geometry, in degrees. Tessellation distances are scaled proportionally to the ratio of 60 degrees to the current camera FOV, so that narrow fields of view (zoom optics, long lenses, binocular views) get detailed water geometry at longer distances. The FOV value used in this calculation is clamped to be no less than this minimum, preventing excessive tessellation at extremely narrow FOV values. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_water_geometry_preset](/code/console/#render_water_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.01f; 60.0f]** - available range **1.5f** - by default | | render_water_geometry_progression_fov_scale | | | **Description:** - **Variable.** � Prints the current intensity of [Global Water](../../objects/objects/water/water_object.md) tessellation compensation for narrow camera fields of view. - **Command.** � Sets the intensity of [Global Water](../../objects/objects/water/water_object.md) tessellation compensation for narrow camera fields of view. Tessellation distances are scaled proportionally to the ratio of 60 degrees to the current camera FOV raised to the power of this value: by 0, the camera FOV does not affect tessellation distances at all; by 1, the scaling is strictly linear. Intermediate values soften the compensation. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_water_geometry_preset](/code/console/#render_water_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.75f** - by default | | render_water_geometry_fade_lods | | | **Description:** - **Variable.** � Prints the current intensity of fading between levels of [Global Water](../../objects/objects/water/water_object.md) geometry tessellation. - **Command.** � Sets the intensity of fading between levels of [Global Water](../../objects/objects/water/water_object.md) geometry tessellation. This value can be increased to remove sharp edges between areas with different geometry density. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_water_geometry_preset](/code/console/#render_water_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 1.0f]** - available range **0.5f** - by default | | render_water_geometry_subpixel_reduction | | | **Description:** - **Variable.** � Prints the current minimum ratio of a polygon size (in screen space) to the size of an area seen in the viewport. - **Command.** � Sets the minimum ratio of a polygon size (in screen space) to the size of an area seen in the viewport. If the ratio calculated for the polygon is less than this value, such polygon will be removed. > **Notice:** Setting the value via this console command changes only the setting stored in the **Custom** preset, and will take effect only when this preset is active (change active preset via *[render_water_geometry_preset](/code/console/#render_water_geometry_preset)*). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one). | **Arguments:** **[0.0f; 50.0f]** - available range **6.0f** - by default | | render_water_culling_aggressive | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if frustum culling optimization is enabled for the [Global Water](../../objects/objects/water/water_object.md). When enabled, the number of culled polygons increases thereby increasing performance. In case of any issues with polygons rendering, try disabling this option (however, note that performance may drop). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_water_culling_frustum_padding | | | **Description:** - **Variable.** � Prints the current value, by which the borders of the current frustum are increased. - **Command.** � Sets the value, by which the borders of the current frustum are increased. Frustum culling is performed for the frustum of the increased size. By the maximum value of 1, the frustum borders will be increased by the size of the current frustum. | **Arguments:** **[0.0f; 1.0f]** - available range **0.1f** - by default | | render_water_culling_oblique_frustum | | | **Description:** - **Variable.** � Prints the current multiplier for the size of viewing frustum used for culling polygons of *[Global Water](../../objects/objects/water/water_object.md)* object beyond the oblique frustum plane. - **Command.** � Sets the multiplier for the size of viewing frustum used for culling polygons of *[Global Water](../../objects/objects/water/water_object.md)* object beyond the oblique frustum plane. The higher the value, the more patches will be culled. | **Arguments:** **[0.0f; 1.0f]** - available range **0.9f** - by default | | render_water_waterline_accuracy | | | **Description:** - **Variable.** � Prints the current quality of underwater and waterline determination. - **Command.** � Sets the quality of underwater and waterline determination. Use high quality only if you need to submerge underwater (to see the waterline) and at medium and high Beaufort values. | **Arguments:** One of the following values: - **0** - low quality - **1** - medium quality - **2** - high quality - **3** - ultra quality The default value is **(0)** | ### Output Modes | render_viewport_mode | | |---|---| | **Description:** - **Variable.** � Prints the current viewport rendering mode. - **Command.** � Sets the viewport rendering mode. The following modes are available: > **Notice:** If the panoramic rendering is enabled, underwater shafts and water line effects will be disabled. - *Default* - default rendering mode. - *Curved Panorama 180* - 180-degree panorama with curved edges. - *Curved Panorama 360* - 360-degree panorama with curved edges. - *Linear Panorama 180* - 180-degree linear panorama without distortion at the edges. - *Linear Panorama 360* - 360-degree linear panorama without distortion at the edges. - *Panorama Fisheye Orthographic* - orthographic spherical panorama (fisheye) with an adjustable Field of View. - *Panorama Fisheye Equidistant* - equidistant (tru-theta or f-theta) spherical panorama (fisheye) with an adjustable Field of View. - *Panorama Fisheye Stereographic* - stereographic spherical panorama (fisheye) with an adjustable Field of View. - *Panorama Fisheye Equisolid* - equisolid (equal-area) spherical panorama (fisheye) with an adjustable Field of View. - *Panorama Fisheye Kannala-Brandt* - Kannala-Brandt fisheye camera model. - *Anaglyph* - stereo mode that is viewed with red-cyan anaglyph glasses. - *Interlaced* - stereo mode that is used with interlaced stereo monitors and polarized 3D glasses. - *Horizontal* - horizontal stereo mode. - *Vertical* - vertical stereo mode. | **Arguments:** **0** - Default (by default) **1** - Curved Panorama 180 **2** - Curved Panorama 360 **3** - Linear Panorama 180 **4** - Linear Panorama 360 **5** - Panorama Fisheye Orthographic **6** - Panorama Fisheye Equidistant **7** - Panorama Fisheye Stereographic **8** - Panorama Fisheye Equisolid **9** - Panorama Fisheye Kannala-Brandt **10** - Anaglyph **11** - Interlaced **12** - Horizontal **13** - Vertical | | render_panorama_fisheye_fov | | | **Description:** - **Variable.** � Prints the current Field of View (in degrees) for the panoramic viewport mode selected at the moment. - **Command.** � Sets the Field of View (in degrees) for the panoramic viewport mode selected at the moment. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to one of the fisheye panorama modes (5-8). | **Arguments:** **[0; 360]** - available range **0** - by default | | render_stereo_distance | | | **Description:** - **Variable.** � Prints the current focal distance for stereo rendering (distance in the world space to the point where two views line up). - **Command.** � Sets the focal distance for stereo rendering (distance in the world space to the point where two views line up). | **Arguments:** **[1e-6f; inf]** - available range **4.0f** - by default | | render_stereo_radius | | | **Description:** - **Variable.** � Prints the current radius for stereo (the half of the separation distance between the cameras). - **Command.** � Sets the radius for stereo (the half of the separation distance between the cameras). | **Arguments:** **[0.0f; inf]** - available range **0.032f** - by default | | render_stereo_offset | | | **Description:** - **Variable.** � Prints the current virtual camera offset (an offset after the perspective projection). - **Command.** � Sets the virtual camera offset (an offset after the perspective projection). | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | | render_stereo_focus_supersampling | | | **Description:** - **Variable.** � Prints the current supersampling factor for focus viewports in the stereo video mode (number of samples per pixel used for adjusting supersampling for focus displays). The main supersampling factor *[render_supersampling](#render_supersampling)* for focus viewports is multiplied by this value. - **Command.** � Sets the supersampling factor for focus viewports in the stereo video mode (number of samples per pixel used for adjusting supersampling for focus displays). The main supersampling factor *[render_supersampling](#render_supersampling)* for focus viewports is multiplied by this value. | **Arguments:** **[1e-6f; 2.0f]** - available range **1.0f** - by default | | render_stereo_hidden_area_enabled | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables support of the stereo hidden area in shaders. Required for stereo modes. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_stereo_hidden_area | | | **Description:** - **Variable.** � Prints the current culling mode for pixels that are not visible in VR mode. - **Command.** � Sets the culling mode for pixels that are not visible in VR mode. One of the following values: This parameter is used for performance optimization. - 0 - hidden area culling is disabled (by default). - 1 - **Runtime-based culling mode**. Culling is performed using meshes returned by the VR runtime (OpenXR, OpenVR, or Varjo). > **Notice:** Culling result depends on HMD used. - **2** - **Custom culling mode**. Culling is performed using meshes returned by the VR runtime and an oval or circular mesh determined by custom adjustable parameters*[render_stereo_hidden_area_transform](#render_stereo_hidden_area_transform)*. | **Arguments:** **0** - disabled (by default) **1** - Runtime-based culling mode **2** - Custom culling mode | | render_stereo_hidden_area_transform | | | **Description:** - **Variable.** � Prints the current size and offset parameters for a new oval or circular mesh to be used for culling pixels, that are not visible in VR mode. - **Command.** � Sets the size and offset parameters for a new oval or circular mesh to be used for culling pixels, that are not visible in VR mode. A four-component vector (X, Y, Z, W), that determines an area to be used for exposure calculation, when culling of pixels, that are not visible in VR mode, is enabled: All components are specified within the **[0.0f, 1.0f]** range - First two components **(X, Y)** - sizes along the X and Y axes respectively. - Second two components **(Z, W)** - offset values along the X and Y axes respectively. > **Notice:** These components can be used only when the hidden area culling mode*[render_stereo_hidden_area](#render_stereo_hidden_area)* is set to 2. | **Arguments:** **(1.0f, 1.0f, 0.0f, 0.0f)** - default value | | render_stereo_hidden_area_exposure_transform | | | **Description:** - **Variable.** � Prints the current area to be used for exposure calculation, when culling of pixels that are not visible in VR mode*[render_stereo_hidden_area](#render_stereo_hidden_area)* is enabled. - **Command.** � Sets the area to be used for exposure calculation, when culling of pixels that are not visible in VR mode*[render_stereo_hidden_area](#render_stereo_hidden_area)* is enabled. Correction of this area is used to avoid visual artefacts when clipped pixels affect exposure in visible areas. A four-component vector (X, Y, Z, W): All components are specified within the **[0.0f, 1.0f]** range. - First two components **(X, Y)** - sizes along the X and Y axes respectively. - Second two components **(Z, W)** - offset values along the X and Y axes respectively. > **Notice:** These components can be used only when the hidden area culling mode*[render_stereo_hidden_area](#render_stereo_hidden_area)* is set to 1 or 2. | **Arguments:** **(0.6f, 0.6f, 0.0f, 0.0f)** - default value | | render_stereo_planar_reflections_per_eye | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables separate rendering of the planar probe reflections for each eye. Requires the corresponding *["Stereo Per Eye"](../../objects/lights/planar/index.md#stereo_per_eye)* option to be enabled. | **Arguments:** **0** - disabled (by default) **1** - enabled | | render_panorama_fisheye_kannala_brandt_image_circle_radius | | | **Description:** - **Variable.** � Prints the current image circle radius for the Kannala-Brandt fisheye camera model. - **Command.** � Sets the image circle radius for the Kannala-Brandt fisheye camera model. The value defines the radius of the valid circular image area produced by the fisheye projection. Pixels outside this radius are considered outside the projected image area. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | **Arguments:** **[-inf; inf]** - available range **0.0f** - by default | | render_panorama_fisheye_kannala_brandt_skew | | | **Description:** - **Variable.** � Prints the current skew coefficient for the Kannala-Brandt fisheye camera model. - **Command.** � Sets the skew coefficient for the Kannala-Brandt fisheye camera model. The skew value controls the non-orthogonality between the image axes. It is typically used when matching the projection to calibrated camera parameters. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | **Arguments:** **[-inf; inf]** - available range **0.0f** - by default | | render_panorama_fisheye_kannala_brandt_image_dimensions | | | **Description:** image dimensions used by the Kannala-Brandt fisheye camera model. The dimensions define the reference image size for interpreting the focal length, principal point, image circle radius, and distortion parameters. Use values that match the calibrated camera resolution. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | | | render_panorama_fisheye_kannala_brandt_principal_point | | | **Description:** principal point for the Kannala-Brandt fisheye camera model. The principal point defines the projection center in image coordinates. It is usually set according to calibrated camera parameters and may differ from the exact image center. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | | | render_panorama_fisheye_kannala_brandt_focal_length | | | **Description:** focal length for the Kannala-Brandt fisheye camera model. The focal length defines the projection scale along the image axes. Use calibrated focal length values to match the rendered fisheye projection to a physical camera lens. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | | | render_panorama_fisheye_kannala_brandt_tangential_distortion | | | **Description:** tangential distortion parameters for the Kannala-Brandt fisheye camera model. Tangential distortion compensates for lens or sensor misalignment relative to the optical axis. Use this setting when calibrated camera data includes tangential distortion values. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | | | render_panorama_fisheye_kannala_brandt_coefficients | | | **Description:** distortion coefficients for the Kannala-Brandt fisheye camera model. These coefficients define the radial distortion curve used by the Kannala-Brandt projection. Use calibrated values to match the output to a real fisheye lens. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | | | render_panorama_fisheye_kannala_brandt_chromatic_aberration | | | **Description:** - **Variable.** � Prints the current chromatic aberration intensity for the Kannala-Brandt fisheye camera model. - **Command.** � Sets the chromatic aberration intensity for the Kannala-Brandt fisheye camera model. The value models lateral chromatic aberration of the lens: the red channel is sampled at the radial distance scaled by (1 - value), the blue channel at (1 + value), while the green channel is the reference. 0 means no chromatic aberration. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | **Arguments:** **[-inf; inf]** - available range **0.0f** - by default | | render_panorama_fisheye_kannala_brandt_vignetting_coefficients | | | **Description:** first four coefficients of the vignetting polynomial for the Kannala-Brandt fisheye camera model. Vignetting is modeled as an even-order polynomial of the radial distance normalized by the image circle radius: the vector components are the coefficients at the 2nd, 4th, 6th, and 8th powers, and the coefficient at the 10th power is set separately via **[getPanoramaFisheyeKannalaBrandtVignettingCoefficient5_float](#getPanoramaFisheyeKannalaBrandtVignettingCoefficient5_float)**. The resulting intensity multiplier is clamped to [0; 1]; all-zero coefficients disable vignetting. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | | | render_panorama_fisheye_kannala_brandt_vignetting_coefficient_5 | | | **Description:** - **Variable.** � Prints the current fifth coefficient of the vignetting polynomial for the Kannala-Brandt fisheye camera model. - **Command.** � Sets the fifth coefficient of the vignetting polynomial for the Kannala-Brandt fisheye camera model. The value is the coefficient at the 10th power of the normalized radial distance; it complements the four coefficients set via **[getPanoramaFisheyeKannalaBrandtVignettingCoefficients_vec4](#getPanoramaFisheyeKannalaBrandtVignettingCoefficients_vec4)** and is kept as a separate value because the vector holds only four components. > **Notice:** Available only when the viewport rendering mode*[render_viewport_mode](#render_viewport_mode)* is set to [Panorama Fisheye Kannala-Brandt](#VIEWPORT_MODE_PANORAMA_FISHEYE_KANNALA_BRANDT). | **Arguments:** **[-inf; inf]** - available range **0.0f** - by default | | render_panorama_force_disable_screen_space_effects | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating whether screen-space effects are to be force-disabled when rendering panoramas. | **Arguments:** **0** - disabled **1** - enabled (by default) | ### Other Settings | render_multithreaded | | |---|---| | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if the multithreaded rendering mode is enabled (DX12 only). | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_latency | | | **Description:** - **Variable.** � Prints the current maximum number of back buffer frames that a driver is allowed to queue for rendering. - **Command.** � Sets the maximum number of back buffer frames that a driver is allowed to queue for rendering. The buffers are used for GPU load optimization: in certain cases several command buffers (frames) can be processed by GPU at once increasing the [**Waiting GPU**](../../tools/profiling/profiler/index.md#present) time for one frame and having zero **Waiting GPU** time for the next ones. Thus, GPU avoids rendering spikes, but increased **Waiting GPU** time will cause a spike in application logic, in case when the logic is bound to [duration of a single frame](../../api/library/engine/class.game_cpp.md#getIFps_float). **Frame latency** is the number of frames that are allowed to be stored in a queue before submission for rendering. Latency is often used to control how the CPU chooses between responding to user input and frames that are in the render queue. In certain cases (high GPU load, VSYNC usage) it may be required to queue more frames of data, it is also beneficial for applications with no user input (e.g., video playback). > **Notice:** Values 1-3 are available for DirectX only. | **Arguments:** **0** - sequential rendering CPU-GPU-CPU-GPU... **1** - 1 buffer (by default) **2** - 2 buffers **3** - 3 buffers | | render_occlusion_queries | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Toggles the value indicating if additional hardware occlusion query test before sending data to GPU is enabled. This test is performed for all objects with the *[Culled by occlusion query](../../editor2/node_parameters/transformation_common/index.md#query)* flag set. | **Arguments:** **0** - disabled **1** - enabled (by default) | | render_occlusion_queries_num_frames | | | **Description:** - **Variable.** � Prints the current number of frames for additional hardware occlusion query test performed before sending data to GPU. - **Command.** � Sets the number of frames for additional hardware occlusion query test performed before sending data to GPU. Make sure that the additional hardware occlusion query test*[render_occlusion_queries](#render_occlusion_queries)* is enabled. | **Arguments:** **[0; 1024]** - available range **5** - by default | | render_virtual_resolution | | | **Description:** - **Variable.** � Prints the current virtual screen resolution. - **Command.** � Sets the virtual screen resolution. This option can be used to render video with high resolution (e.g. 8K) regardless of monitor's resolution. | **Arguments:** **-1; -1** - default value | | render_max_fps | | | **Description:** - **Variable.** � Prints the current maximum FPS value, to which rendering FPS is to be clamped. - **Command.** � Sets the maximum FPS value, to which rendering FPS is to be clamped. 0 - disables FPS clamping. Both [VSync](../../code/fundamentals/execution_sequence/index.md#waiting_gpu), and *Max FPS* are actually about an additional idle period at the end of the frame. In case of *VSync* the Engine shall wait for the monitor to draw the whole image, while *Max FPS* enables you to specify any value for the delay (even a fractional, like 24.5). This clamping limit can be used for both debugging purposes and in the final build as well enabling you to smooth an unstable "jigsaw" framerate. For example, in case FPS jumps between 45 and 90, setting *Max FPS* to 45 may significantly improve your application's response visually. | **Arguments:** **[0.0f; inf]** - available range **0.0f** - by default | ## Renderers ### OpenAL Settings Operations on the *OpenAL* API. | al_sound_renderer | | |---|---| | **Description:** - **Command.** Prints the information on the sound card. | | | al_sound_vendor | | | **Description:** - **Command.** Prints the manufacturer of the OpenAL driver. | | | al_sound_version | | | **Description:** - **Command.** Prints the version of the OpenAL driver. | | | al_sound_extensions | | | **Description:** - **Command.** Prints the available OpenAL sound extensions. | | | alc_sound_extensions | | | **Description:** - **Command.** Prints OpenAL context sound extensions. | | | al_sound_skip_errors | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables skipping of OpenAL errors. | **Arguments:** **0** - disabled (by default) **1** - enabled | ## Plugins Operations on external plugins. | plugin_load | | |---|---| | **Description:** - **Command.** Loads an external plugin. | **Arguments:** External plugin name | | plugin_reload | | | **Description:** - **Command.** Reloads an external plugin. | **Arguments:** External plugin name | | plugin_unload | | | **Description:** - **Command.** Quits and unloads an external plugin. > **Notice:** Also available as **plugin_destroy**. | **Arguments:** External plugin name | ## Bake Lighting Operations on the Bake Lighting tool. | bake_lighting_bounces | | |---|---| | **Description:** - **Variable.** � Prints the current [number of light bounces](../../editor2/lighting/gi/bake_lighting/index.md#common). - **Command.** � Sets the [number of light bounces](../../editor2/lighting/gi/bake_lighting/index.md#common). | **Arguments:** **[1; 32]** - available range **1** - by default | | bake_lighting_samples_per_frame | | | **Description:** - **Variable.** � Prints the current [number of voxels](../../editor2/lighting/gi/bake_lighting/index.md#common) computed and visualized per single frame during bake lighting process (higher values cause longer UI response, but speed up calculations). - **Command.** � Sets the [number of voxels](../../editor2/lighting/gi/bake_lighting/index.md#common) computed and visualized per single frame during bake lighting process (higher values cause longer UI response, but speed up calculations). | **Arguments:** **[1; 500]** - available range **10** - by default | | bake_lighting_voxel_size_multiplier | | | **Description:** - **Variable.** � Prints the current [voxel size multiplier](../../editor2/lighting/gi/bake_lighting/index.md#voxel_probes). - **Command.** � Sets the [voxel size multiplier](../../editor2/lighting/gi/bake_lighting/index.md#voxel_probes). | **Arguments:** **[0.0f; 8.0f]** - available range **1.0f** - by default | | bake_lightmap_viewport_mask | | | **Description:** - **Variable.** Prints the current viewport mask for the lightmapper. - **Command.** Assigns a new [viewport mask](../../editor2/lighting/gi/bake_lighting/index.md#lightmaps) for the lightmapper. For a light or surface to contribute to static GI, their viewport masks should match the baking [viewport mask](../../principles/bit_masking/index.md#viewport). | **Arguments:** Viewport mask | | bake_lightmap_zfar | | | **Description:** - **Variable.** � Prints the current [far clipping distance](../../editor2/lighting/gi/bake_lighting/index.md#lightmaps) for light rays used when baking lightmaps. - **Command.** � Sets the [far clipping distance](../../editor2/lighting/gi/bake_lighting/index.md#lightmaps) for light rays used when baking lightmaps. | **Arguments:** **[0.0f; inf]** - available range **1000.0f** - by default | | bake_lightmap_quality | | | **Description:** - **Variable.** � Prints the current global baking quality for [lightmaps](../../editor2/lighting/gi/bake_lighting/index.md#lightmaps). - **Command.** � Sets the global baking quality for [lightmaps](../../editor2/lighting/gi/bake_lighting/index.md#lightmaps). | **Arguments:** **0** - Draft **1** - Low **2** - Medium (by default) **3** - High **4** - Ultra | | bake_lighting_start | | | **Description:** - **Command.** Starts bake lighting. | | | bake_lighting_stop | | | **Description:** - **Command.** Stops bake lighting. | | ## Screenshots Operations on screenshots. | screenshot_extension | Config file: [*.user](../../code/configuration_file_cpp.md#user) | |---|---| | **Description:** - **Variable.** � Prints the current screenshot format. - **Command.** � Sets the screenshot format. | **Arguments:** Extension for screenshot files: "png", "jpg", "dds", "tga", etc... ("tga" is used by default) | | screenshot | | | **Description:** - **Command.** Takes a screenshot. > **Notice:** A screenshot is saved in the `bin/screenshots` directory by default. You can specify another directory. | **Arguments:** `Path` to the folder the screenshots will be saved in (optional) | ## Memory Allocator | memory_clear | |---| | **Description:** - **Command.** Clears the video memory, ffp buffer and memory pools, deletes textures and all meshes, including skinned meshes and decals. Memory is cleared automatically after the world is loaded or the render preset has been changed. It is recommended to use this command only in case a significant amount of memory needs to be released, the resources will be force removed at the end of the frame. | | memory_clear_soft | | **Description:** - **Command.** Softly clears the video memory. Destroys unused textures and meshes and clears memory pools. | ### RAM Allocations Operations on memory allocations. | memory_info | | |---|---| | **Description:** - **Command.** Prints [information](../../principles/allocator/index.md#analyze_ram_pools) on small allocations in the static and dynamic memory pools. | | | memory_statistics_enabled | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables gathering memory statistics during the application start-up. After starting up prints the value indicating whether gathering memory statistics is enabled or not. > **Notice:** Available only during the Engine initialization (startup), has no effect at run time. | **Arguments:** **0** - disabled **1** - enabled (by default) | | memory_optimize_static_pools | | | **Description:** - **Command.** Updates and optimizes the static memory pools. The command can receive three arguments. | **Arguments:** - ***by_default*** - a flag indicating if the pool will be optimized for all the platforms or it will be customized for the current binary executable. To optimize pools for the current platform according to the current configuration, pass false. This way you can create several configurations of the static pools for different platforms. The default value is true. - ***overflow*** - a permissible difference between the maximum potential memory consumption and the current memory consumption. This value can be useful for reducing allocations during memory spikes. When set to 0, it generates the static pools based on current memory consumption. The default value is 64 Mb. - ***max_size*** - the maximum size of all static pools. The default value is 8192 Mb. | | memory_dynamic_pool | | | **Description:** - **Variable.** Sets the maximum size of the dynamic pool in bytes. - **Command.** Prints the maximum size of the dynamic pool in bytes. | **Arguments:** Pool size in bytes. 256 by default. | ### VRAM Allocations For more details about heap types, please refer to [this article](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_heap_type). Operations on video memory allocations. | video_memory_info | | |---|---| | **Description:** - **Command.** Prints [information](../../principles/allocator/index.md#analyze_vram_pools) on small video memory allocations. | | | d3d12_small_pool_enabled | | | **Description:** - **Variable.** Toggles small pool allocations on and off. You should call the [`boot_config_save`](#boot_config_save) command and restart the application to save and apply changes. - **Command.** Prints the value indicating whether small pool allocations are enabled or not. | **Arguments:** - 0 to disable allocations - 1 to enable allocations | | d3d12_gpu_upload_heap | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables the use of a persistent GPU upload heap for staging data from CPU to GPU. > **Notice:** Support for GPU upload heaps depends on hardware capabilities. It is available on systems with **integrated GPUs** or **discrete GPUs with full CPU access to GPU** memory (e.g., when *Resizable BAR* is enabled). On unsupported systems, the setting **has no effect**. | **Arguments:** **0** - disabled **1** - enabled (by default) | | d3d12_memory_pool_heap_default | | | **Description:** - **Variable.** � Prints the current default heap memory pool size, in megabytes, for allocations in GPU-local memory. - **Command.** � Sets the default heap memory pool size, in megabytes, for allocations in GPU-local memory. | **Arguments:** **[0; 16384]** - available range **64** - by default | | d3d12_memory_pool_heap_gpu_upload | | | **Description:** - **Variable.** � Prints the current GPU upload heap memory pool size, in megabytes, for allocations used to upload data from system memory to GPU memory. - **Command.** � Sets the GPU upload heap memory pool size, in megabytes, for allocations used to upload data from system memory to GPU memory. | **Arguments:** **[0; 16384]** - available range **16** - by default | | d3d12_memory_pool_heap_readback | | | **Description:** - **Variable.** � Prints the current readback heap memory pool size, in megabytes, for allocations used to read data back from GPU to system memory. - **Command.** � Sets the readback heap memory pool size, in megabytes, for allocations used to read data back from GPU to system memory. | **Arguments:** **[0; 16384]** - available range **64** - by default | | d3d12_memory_pool_heap_upload | | | **Description:** - **Variable.** � Prints the current upload heap memory pool size, in megabytes, for upload allocations in system memory. - **Command.** � Sets the upload heap memory pool size, in megabytes, for upload allocations in system memory. | **Arguments:** **[0; 16384]** - available range **8** - by default | | d3d12_memory_pool_texture | | | **Description:** - **Variable.** � Prints the current texture memory pool size, in megabytes, for texture allocations in GPU memory. - **Command.** � Sets the texture memory pool size, in megabytes, for texture allocations in GPU memory. | **Arguments:** **[0; 16384]** - available range **128** - by default | | d3d12_memory_pool_texture_staging | | | **Description:** - **Variable.** � Prints the current staging texture memory pool size, in megabytes, for staging texture allocations in system memory. - **Command.** � Sets the staging texture memory pool size, in megabytes, for staging texture allocations in system memory. | **Arguments:** **[0; 16384]** - available range **32** - by default | | d3d12_frame_pool_upload | | | **Description:** - **Variable.** � Prints the current current size of the CPU-visible frame upload pool used to allocate per-frame constant buffers and other transient data. - **Command.** � Sets the current size of the CPU-visible frame upload pool used to allocate per-frame constant buffers and other transient data. | **Arguments:** **[0; 16384]** - available range **128** - by default | | d3d12_frame_pool_gpu_upload | | | **Description:** - **Variable.** � Prints the current current size of the GPU frame upload pool, which is used for per-frame allocations such as material constant buffers. - **Command.** � Sets the current size of the GPU frame upload pool, which is used for per-frame allocations such as material constant buffers. | **Arguments:** **[0; 16384]** - available range **128** - by default | #### Skinned Meshes and Decals Allocations | skinned_pool_chunk_size | | |---|---| | **Description:** - **Variable.** � Prints the current size of the VRAM chunk to be allocated within a separate pool for a skinned mesh. - **Command.** � Sets the size of the VRAM chunk to be allocated within a separate pool for a skinned mesh. Reducing the chunk size may negatively impact performance, since skinned geometry is processed more efficiently when it resides within a single chunk. | **Arguments:** **[4; 512]** - available range **64** - by default | | decal_pool_chunk_size | | | **Description:** - **Variable.** � Prints the current size of the VRAM chunk to be allocated within a separate pool for a decal. - **Command.** � Sets the size of the VRAM chunk to be allocated within a separate pool for a decal. | **Arguments:** **[4; 512]** - available range **16** - by default | ## General Information ### CPU Info Operations, representing information on the CPU. | cpu_info | | |---|---| | **Description:** - **Command.** Prints information on the CPU and instruction set supported by it. | | | cpu_frequency | | | **Description:** - **Command.** Prints the CPU frequency in MHz. | | | cpu_cores | | | **Description:** - **Command.** Prints the number of available CPU cores. | | | cpu_threads | | | **Description:** - **Variable.** � Prints the current CPU threads available. - **Command.** � Sets the CPU threads available. | **Arguments:** **[0; 1024]** - available range **0** - by default | | cpu_hyper_threading | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables CPU hyper threading. | **Arguments:** **0** - disabled (by default) **1** - enabled | ### System Info Operations representing information on the system. | binary_info | |---| | **Description:** - **Command.** Prints information on the engine binary. | | system_info | | **Description:** - **Command.** Prints detailed information about the Engine, OS, CPU and GPU. | | os_info | | **Description:** - **Command.** Prints information about the operating system. | ## USC Scripts Operations on the world, system and editor scripts. ### Editor Script Analyzer Operations on the [editor script](../../code/fundamentals/execution_sequence/app_logic_system.md#editor_script) debugging. > **Notice:** Available only for debug builds. | editor_memory_usage | | |---|---| | **Description:** - **Command.** Prints memory usage by the editor script to the console or dump into a specified file. | **Arguments:** `Path` to a file to dump the information into (optional) | | editor_analyze | | | **Description:** - **Command.** Analyzes the performance of the editor script. The information can be printed to the console or dumped into a specified file. | **Arguments:** `Path` to the log file to dump the [log file](../../code/performance_analyzer.md) information into (optional) | | editor_disassemble | | | **Description:** - **Command.** Disassembles the editor script. The information can be printed to the console or dumped into a specified file. | **Arguments:** `Path` to a file to dump the information into (optional) | ### System Script Analyzer Operations on the [system script](../../code/fundamentals/execution_sequence/app_logic_system.md#system_script) debugging. > **Notice:** Available for debug builds only. | system_memory_usage | | |---|---| | **Description:** - **Command.** Prints memory usage by the system script to the console or dump into a specified file. | **Arguments:** `Path` to a file to dump the information into (optional) | | system_analyze | | | **Description:** - **Command.** Analyzes the performance of the system script. The information can be printed to the console or dumped into a specified file. | **Arguments:** `Path` to the log file to dump the [log file](../../code/performance_analyzer.md) information into (optional) | | system_disassemble | | | **Description:** - **Command.** Disassembles the system script. The information can be printed to the console or dumped into a specified file. | **Arguments:** `Path` to a file to dump the information into (optional) | ### World Script Analyzer Operations on the [world script](../../code/fundamentals/execution_sequence/app_logic_system.md#world_script) debugging. > **Notice:** Available for debug builds only. | world_memory_usage | | |---|---| | **Description:** - **Command.** Prints memory usage by the world script to the console or dump into a specified file. | **Arguments:** `Path` to a file to dump the information into (optional) | | world_analyze | | | **Description:** - **Command.** Analyzes the performance of the world script. The information can be printed to the console or dumped into a specified file. | **Arguments:** `Path` to the log file to dump the [log file](../../code/performance_analyzer.md) information into (optional) | | world_disassemble | | | **Description:** - **Command.** Disassembles the world script. The information can be printed to the console or dumped into a specified file. | **Arguments:** `Path` to a file to dump the information into (optional) | ### Script Debugger Operations on the per-function breakpoint. The syntax to set the breakpoint is the following: ```text system_breakpoint/world_breakpoint/editor_breakpoint set/remove function_name number_of_arguments ``` | world_breakpoint | | |---|---| | **Description:** - **Command.** Sets a [breakpoint](../../code/uniginescript/language/debugging.md#debugger_runtime) to the specified function in the world script. The syntax to set the breakpoint is the following: ```text world_breakpoint set/remove function_name number_of_arguments ``` | **Arguments:** 1. Name of **function** 2. **Number** of arguments | | system_breakpoint | | | **Description:** - **Command.** Sets a [breakpoint](../../code/uniginescript/language/debugging.md#debugger_runtime) to the specified function in the system script. The syntax to set the breakpoint is the following: ```text system_breakpoint set/remove function_name number_of_arguments ``` | **Arguments:** 1. Name of **function** 2. **Number** of arguments | | editor_breakpoint | | | **Description:** - **Command.** Set a [breakpoint](../../code/uniginescript/language/debugging.md#debugger_runtime) to the specified function in the editor script. The syntax to set the breakpoint is the following: ```text editor_breakpoint set/remove function_name number_of_arguments ``` | **Arguments:** 1. Name of **function** 2. **Number** of arguments | ## Miscellaneous Miscellaneous commands. | gpu_thread_priority | | |---|---| | **Description:** - **Variable.** � Prints the current GPU thread priority for the engine. - **Command.** � Sets the GPU thread priority for the engine. Available for DirectX only. Positive values increase the likelihood that the GPU scheduler will grant GPU execution cycles to the device when rendering. You should have a comprehensive understanding of GPU scheduling and profile your application to ensure that it behaves as intended. If used inappropriately, this parameter can impede rendering speed and result in a poor user experience. | **Arguments:** **[-7; 7]** - available range **7** - by default | | process_priority | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current engine process priority. - **Command.** � Sets the engine process priority. Available for Windows only. A process with a higher priority gets to use the free CPU time available while a lower priority process only has access to the CPU when the higher priority application doesn't need it. If used inappropriately, may significantly affect performance. | **Arguments:** **0** - idle **1** - normal (by default) **2** - high **3** - real-time | | log_stdout | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables log messages printing in stdout. > **Notice:** Logging to stdout may significantly affect performance, so switch this option off, when you don't need it. You can use [log_file](#log_file) for debugging purposes, as it is more performance-friendly. | **Arguments:** **0** - disabled **1** - enabled (by default) | | log_file | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables log messages saving in the Engine's log file. > **Notice:** This option is used for debugging. Do not turn it off if you need to debug something. | **Arguments:** **0** - disabled **1** - enabled (by default) | | dpi_awareness | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current DPI awareness mode, the value indicating how the application processes the DPI scaling. - **Command.** � Sets the DPI awareness mode, the value indicating how the application processes the DPI scaling. | **Arguments:** **-1** � user configures DPI awareness. **0** - all displays are default DPI, bitmap-stretching. **1** - all displays have the same DPI from primary display, bitmap-stretching. (by default) **2** - DPI of the display that the window is primarily located on, no DPI scaling of any UI elements. Not available on Linux. | | auto_dpi_scaling | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables applying automatic scaling to the window content. | **Arguments:** **0** - disabled **1** - enabled (by default) | | swap_delay_warning | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � Enables displaying of the warning to the console that the swap has not been called within the period specified by [swap_delay_warning_time](#swap_delay_warning_time). | **Arguments:** **0** - disabled (by default) **1** - enabled | | swap_delay_warning_time | Config file: [*.boot](../../code/configuration_file_cpp.md#boot) | | **Description:** - **Variable.** � Prints the current time in milliseconds, during which the swap should be called, otherwise [swap_delay_warning](#swap_delay_warning) is displayed in the console. - **Command.** � Sets the time in milliseconds, during which the swap should be called, otherwise [swap_delay_warning](#swap_delay_warning) is displayed in the console. | **Arguments:** **[1.0; 1000000.0]** - available range **200.0** - by default | | license_info | | | **Description:** Prints license information on all third-party libraries used. | | | render_gpu_resource_aliasing | | | **Description:** - **Variable.** � Prints a value indicating if the option controlled by the command below is enabled. - **Command.** � - **Variable.** Reuse resources memory. | **Arguments:** **0** - disabled **1** - enabled (by default) | | rtsp_streamer_profiling | | | **Description:** - **Command.** Enables or disables timing instrumentation (CUDA events, CPU timers, and NVML encoder utilization sampling) for the [RTSPStreamer](../../code/plugins/rtspstreamer/index_cpp.md) plugin, and shows or hides the plugin's debug window. When disabled, no timings are measured at all. The command appears only after the plugin has initialized successfully: the plugin is provided for desktop platforms only, requires a build with CUDA support, and registers no console commands if the RTSP server fails to start. | **Arguments:** - 0 - disable profiling and hide the debug window (by default) - 1 - enable profiling and show the debug window | | rtsp_streamer_show_debug_info | | | **Description:** - **Command.** Shows or hides the stream information overlay of the [RTSPStreamer](../../code/plugins/rtspstreamer/index_cpp.md) plugin. The overlay is drawn into the streamed frames themselves, unlike the local debug window toggled by [rtsp_streamer_profiling](#rtsp_streamer_profiling), and displays the stream URL, the number of connected clients, encoder information, the name of the Player node being streamed, the frame rate and the stream time. The command applies to the streams that exist at the moment it is run: streams added later start with the overlay hidden. | **Arguments:** - 0 - hide the overlay (by default) - 1 - show the overlay | | scenario_manager_log | | | **Description:** - **Variable.** Prints whether the [Scenario Manager](../../code/plugins/scenariomanager/index.md) plugin writes its messages, warnings, and errors to the engine log. - **Command.** Enables or disables the plugin's log output. Available while the plugin is loaded. | **Arguments:** - 1, on, or true - enable logging (by default) - 0, off, or false - disable logging | | scenario_manager_server | | | **Description:** - **Variable.** Prints the address and port the built-in HTTP server of the [Scenario Manager](../../code/plugins/scenariomanager/index.md) plugin is bound to, and whether it is listening. - **Command.** Changes the bind target of the HTTP server that hosts the [Scenario Manager editor](../../code/plugins/scenariomanager/editor.md), and starts the server if it was left closed at start-up. Rebinding drops all connected clients; if the new address and port cannot be bound, the previous ones are restored. Available while the plugin is loaded. | **Arguments:** - a port number alone - rebind to this port, keeping the current address. The port must be in the [1; 65535] range - an address in the *xxx.xxx.xxx.xxx* format followed by a port number - rebind to both `127.0.0.1` and `8080` by default. Keep the server on the loopback address unless remote access is really required: binding it to `0.0.0.0` exposes the Scenario Manager editor to the whole network, and no authentication is performed in front of it. |