This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
专业(SIM)
UnigineEditor
界面概述
资源工作流程
版本控制
设置和首选项
项目开发
调整节点参数
Setting Up Materials
设置属性
照明
Sandworm
使用编辑器工具执行特定任务
如何擴展編輯器功能
嵌入式节点类型
Nodes
Objects
Effects
Decals
光源
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
使用范例
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
材质和着色器
Rebuilding the Engine Tools
GUI
VR Development
双精度坐标
应用程序接口
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
创建内容
内容优化
材质
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
注意! 这个版本的文档是过时的,因为它描述了一个较老的SDK版本!请切换到最新SDK版本的文档。
注意! 这个版本的文档描述了一个不再受支持的旧SDK版本!请升级到最新的SDK版本。

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 ConsoleHow to Open Console#

A built-in console is called by pressing the F1 key:

The console can be hidden by pressing the F1 key one more time. See how to assign another key here.

Console OperationConsole 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 SyntaxCommand Syntax#

Console command can take null, one or several arguments. The syntax is:

源代码
command_to_execute // null argument
command_to_execute argument // one argument
command_to_execute argument argument // two arguments

Hints

  • To see the current 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:
    源代码
    Main window resizable toggle
    0 is non-resizable mode
    1 is resizable mode
    main_window_resizable = 1
  • To complete a command or variable name, just start typing first letters and press the TAB key until you get the required result.

How to Change the Console Opening KeyHow to Change the Console Opening Key#

If you want to change the default F1 console turning on or off 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. For example, to set the back quote key, specify BACK_QUOTE (or 17):

源代码 (XML)
<console_key>BACK_QUOTE</console_key>

You can also specify several comma-separated keys:

源代码 (XML)
<console_key>BACK_QUOTE,F3,18</console_key>

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. For example, to set the Left Ctrl+` shourtcut, change the user configuration file as follows:

源代码 (XML)
<console_key>BACK_QUOTE</console_key>
<console_key_modifier>LEFT_CTRL</console_key>

注意
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.

ConsoleConsole#

Basic operations on the console, command and variable.

bind配置文件: *.user
说明/描 述:
  • Command. Binds a key to a command.
    For example, to bind the asterisk (*) key to the world_reload command, type:
    源代码
    Unigine~# bind * world_reload
参数:
  1. Key to bind
  2. Command to execute
clear
说明/描 述:
  • Command. Clears all messages from the console window.
console_key配置文件: *.user
说明/描 述:
  • Variable. Prints the scancode or the name of the current console turning on or off key.
  • Command. Assigns a new key to turn on or off the console.
参数:
Key scancode or name from the list.
Several comma-separated arguments are allowed.
console_key_modifier配置文件: *.user
说明/描 述:
  • Variable. Prints the code or the name of the current modifier set for the console turning on or off key.
  • Command. Assigns a new key modifier for the console turning on and off key.
参数:
Modifier code or name from the list.
help
说明/描 述:
  • Command. Prints the list of the built-in commands.
hide
说明/描 述:
  • Command. Hides the console.
ls
说明/描 述:
  • Command. Prints a set of all available console keys, commands and variables.
show
说明/描 述:
  • Command. Show the console.
switch
说明/描 述:
  • Command. Switches among all variable values.
    注意
    Make sure that the variable is an integer.
参数:
Variable, which values will be switched
toggle
说明/描 述:
  • Command. Enables or disables a variable.
    注意
    Enabled variable will have a default value.
    For example, if you toggle the show_visualizer variable, you will get the following result:
    源代码
    toggle show_visualizer
    show_visualizer = 0 // disabled visualizer
    toggle show_visualizer
    show_visualizer = 1 // enabled visualizer
参数:
Variable to be toggled
unbind
说明/描 述:
  • Command. Unbinds a key from a command.
参数:
Key to unbind
console_limit配置文件: *.user
说明/描 述:
  • 变量。   打印当前值maximum number of messages the console can output.
  • 命令。   设置 maximum number of messages the console can output.
参数:
[0; INT_MAX] - 可用范围
16384 - 默认
console_height配置文件: *.user
说明/描 述:
  • 变量。   打印当前值console height in percentage of the window height.
  • 命令。   设置 console height in percentage of the window height.
参数:
[0; 100] - 可用范围
75 - 默认

Console GUIConsole GUI#

Operations on the console GUI.

console_size配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值size for the console font.
  • 命令。   设置 size for the console font.
参数:
[4; 32] - 可用范围
16 - 默认
console_font配置文件: *.boot
说明/描 述:
  • 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.
参数:
Path to a *.ttf file
core/gui/console.ttf (by default)
console_onscreen配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of the onscreen overlay.
参数:
0 - 关 (默认)
1 -
console_onscreen_font_size配置文件: *.user
说明/描 述:
  • 变量。   打印当前值size for the onscreen overlay.
  • 命令。   设置 size for the onscreen overlay.
参数:
[4; 32] - 可用范围
14 - 默认
console_onscreen_height配置文件: *.user
说明/描 述:
  • 变量。   打印当前值height of the onscreen overlay in percentage of the window height.
  • 命令。   设置 height of the onscreen overlay in percentage of the window height.
参数:
[0; 100] - 可用范围
20 - 默认
console_onscreen_time配置文件: *.user
说明/描 述:
  • 变量。   打印当前值the time in seconds during which the text is displayed on the screen.
  • 命令。   设置 the time in seconds during which the text is displayed on the screen.
参数:
[0.0f; 100.0f] - 可用范围
2.0f - 默认
console_wrapping配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables word wrapping for the Console.
参数:
0 - 关 (默认)
1 -

EngineEngine#

Basic operations on the engine.

background_update配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   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.
参数:
0 - 关 (默认)
1 -
engine_version_info
说明/描 述:
  • Command. Prints the current engine version info.
quit
说明/描 述:
  • Command. Quits the engine.
splash_screen配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Sets the value indicating whether the Splash screen is enabled at the engine start-up.
参数:
0 -
1 - 开 (默认)

Engine Configuration FilesEngine Configuration Files#

General operations on the engine configuration.

boot_config
说明/描 述:
参数:
Path to the Engine startup configuration file
(data/default.boot by default)
boot_config_autosave
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables automatic saving of current Engine startup configuration settings to the file specified by the boot_config variable on loading, closing, and saving the world, as well as on the Engine shutdown.
参数:
0 - 关 (默认)
1 -
boot_config_load
说明/描 述:
  • Command. Loads Engine startup configuration settings from a configuration file specified by the boot_config variable (configs/default.boot by default).
boot_config_save
说明/描 述:
  • Command. Saves Engine startup configuration settings to a configuration file specified by the boot_config variable (configs/default.boot by default).
config配置文件: *.boot
说明/描 述:
参数:
Path to the application configuration file
(configs/default.config by default)
config_autosave
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables automatic saving of current application configuration settings to the file specified by the config variable on loading, closing, and saving the world, as well as on the Engine shutdown.
参数:
0 -
1 - 开 (默认)
config_load
说明/描 述:
  • Command. Loads the application configuration settings from a configuration file specified by the config variable (configs/default.config by default).
config_save
说明/描 述:
  • Command. Saves the current application configuration settings to a configuration file specified by the config variable (configs/default.config by default).
controls_config配置文件: *.boot
说明/描 述:
参数:
Path to the controls configuration file
(configs/default.controls by default)
controls_config_autosave
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables automatic saving of current controls configuration settings to the file specified by the controls_config variable on loading, closing, and saving the world, as well as on the Engine shutdown.
参数:
0 -
1 - 开 (默认)
controls_config_load
说明/描 述:
controls_config_save
说明/描 述:
user_config配置文件: *.boot
说明/描 述:
参数:
Path to the user configuration file
(configs/default.user by default)
user_config_autosave
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables automatic saving of current user configuration settings to the file specified by the user_config variable on loading, closing, and saving the world, as well as on the Engine shutdown.
参数:
0 -
1 - 开 (默认)
user_config_load
说明/描 述:
user_config_save
说明/描 述:

WorldWorld#

Basic operations on world.

starting_world配置文件: *.boot
说明/描 述:
  • 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.
参数:
A world name or a path to a world relative to the -data_path folder.
world_load
说明/描 述:
  • Loads the specified world. A cache file can also be specified for faster application loading.
参数:
  1. Name of the world to load (inside the data directory)
  2. Name of the world cache file (optional)
world_quit
说明/描 述:
  • Clears all the world data.
world_save
说明/描 述:
  • Saves the current world to a file (*.world).
    注意
    Materials won't be saved on running the command. To save them, use materials_save.
world_reload
说明/描 述:
  • Reloads the world. A cache file can also be specified to be reloaded.
参数:
Name of the world cache file (optional)

World ResourcesWorld Resources#

Operations, representing information on objects generated using CPU logic, such as ObjectGrass, ObjectMeshClutter and WorldClutter objects.

world_manager_info
说明/描 述:
  • Command. Print general information (the number of registered/loaded resources; used memory) on world manager resources, such as:
    • ImageManaged - loaded images (if not fully loaded, a dummy texture or one-mipmap texture is used)
    • PathManaged - loaded splines
    • ImageStream - streamed mask images
    • MeshStream - streamed meshes used as an intersection mask for grass or clutters
world_manager_list
说明/描 述:
  • Command. Prints the list of resources handled by the world manager (mask images for ObjectGrass and WorldClutter objects), if any.
world_spawn_list
说明/描 述:
  • 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配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值cache memory limit for images in MB.
  • 命令。   设置 cache memory limit for images in MB.
参数:
[0; 8192] - 可用范围
128 - 默认
world_manager_meshes_memory配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值cache memory limit for meshes in MB.
  • 命令。   设置 cache memory limit for meshes in MB.
参数:
[0; 8192] - 可用范围
128 - 默认

SoundSound#

Operations on the sound.

sound_occlusion
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables occlusion of a sound if other nodes are found in front of the sound source.
参数:
0 -
1 - 开 (默认)
sound_reverb
说明/描 述:
  • 变量。   打印当前值sound reverberation mode.
  • 命令。   设置 sound reverberation mode.
参数:
0 - sound reverberation is disabled
1 - single-environment sound reverberation
2 - multi-environment sound reverberation (默认)

Sound ResourcesSound Resources#

Operations on the sound resources.

sound_manager_load_samples
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables preloading sound samples on world loading (ensure there are no lags afterwards but increases loading time and memory footprint).
参数:
0 - 关 (默认)
1 -
sound_manager_info
说明/描 述:
  • Command. Prints general information on sound resources: the number of static and streamed sound sources (registered/loaded; memory used).
sound_manager_list
说明/描 述:
  • Command. Prints the detailed list of sound files, if any, with used space.
sound_manager_sample_static_memory
说明/描 述:
  • 变量。   打印当前值cache memory limit for static sound resources in Mb.
  • 命令。   设置 cache memory limit for static sound resources in Mb.
参数:
[1; 1024] - 可用范围
64 - 默认
sound_manager_sample_stream_memory
说明/描 述:
  • 变量。   打印当前值cache memory limit for streamed sound resources in Mb.
  • 命令。   设置 cache memory limit for streamed sound resources in Mb.
参数:
[1; 1024] - 可用范围
16 - 默认

Material ManagerMaterial Manager#

Operations on materials.

material_manager_info
说明/描 述:
  • Command. Prints information on all loaded materials (e.g. the number of loaded shaders; states, textures and parameters that don't exist in the parent material).
materials_loading_mode配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值materials loading mode.
  • 命令。   设置 materials loading mode.
参数:
0 - Minimal memory consumption and maximum Engine loading speed. Сaching for materials and shaders is disabled, so everything is loaded on demand resulting in lots of freezes, spikes, etc. This method can be used when spikes are less important than memory consumption. It is recommended for fast iterations during the application development phase as less time is spent on launching your application and loading resources.
1 - Caching is enabled for materials, so materials are created at Engine's startup rather than at run time. Engine startup takes more time than for the first mode and more memory is used. There are less spikes in this mode, but they occur sometimes. This mode can be enabled on a constant basis for a small project having a small number of materials (in case of satisfactory performance and sufficient memory amount).
2 - Caching of materials is enabled along with shader cache generation and loading. This mode requires compilation of all shaders resulting in very long loading times. Everything is kept in memory with no streaming required. This mode is the best as it ensures stable work and significant reduction of spikes.
注意
In case of large projects with tens of thousands of materials the amount of available memory can be exceeded, as shader cache takes a lot of it.
Thus, it is recommended to be used for production phase (when you hand over you application to the end user). (默认)
materials_reload
说明/描 述:
  • Command. Reloads all loaded materials and used shaders. Shader variables are updated automatically. It can be called, for example, for graphics API changes to come to effect.
materials_save
说明/描 述:
  • Command. Saves all loaded materials.
shaders_create
说明/描 述:
  • Command. Creates all shaders for all loaded materials, updates the shaders cache if necessary, and loads shaders to RAM.
shaders_compile
说明/描 述:
  • Command. Compiles shaders for all loaded materials.
shaders_destroy
说明/描 述:
  • Command. Removes all shaders from RAM.
    注意
    This command can be used to clear RAM after shader cache generation.

CameraCamera#

Operations for fast positioning of the game camera.

camera_get
说明/描 述:
  • Command. Returns the current position of the game camera and its rotation (Euler angles).
camera_set
说明/描 述:
  • Command. Set position and rotation (Euler angles) of the game camera.
    注意
    Position and rotation of the game camera can be changed only if the camera is unlocked.
    源代码
    camera_set 20.0 19.0 3.0 0.0 45.0 90.0
参数:
The first 3 arguments set position.
The second 3 arguments set rotation (optional)

File SystemFile System#

Operations on the File system.

filesystem_clear_paths
说明/描 述:
  • Command. Removes all non-existent file system paths.
filesystem_mmap配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables the use of memory-mapped files for faster access.
参数:
0 -
1 - 开 (默认)
filesystem_reload
说明/描 述:
  • Command. Reloads the file system, thereby update the list of files.
filesystem_save_guids
说明/描 述:
  • Command. Saves all file system guids to the specified file path in JSON format, or binary format if the corresponding flag is set.
参数:
  1. Path to the file
  2. Binary flag - save guids to a file in binary format (optional)

File System InfoFile System Info#

Operations, representing information on the File system.

filesystem_guids
说明/描 述:
  • Command. Prints the list of all file system guids.
filesystem_info
说明/描 述:
  • Command. Print general file system information (the total number of files and files per package).
filesystem_list
说明/描 述:
  • Command. Print the list of all files.

AssetsAssets#

Operations on assets.

assets_info
说明/描 述:
  • Command. Prints information on the number of non-native assets and runtime files generated for them.
assets_list
说明/描 述:
  • Command. Prints the list of all non-native assets and information on runtime files generated for them (file path, alias).

Import and ExportImport and Export#

Operations representing information on importers and exporters of models.

import_info
说明/描 述:
  • 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
说明/描 述:
  • Command. Prints information on the registered exporters of the models.

ScriptsScripts#

Operations on the world, system and editor scripts.

Editor Script AnalyzerEditor Script Analyzer#

Operations on the editor script debugging.

注意
Available only for debug builds.
editor_memory_usage
说明/描 述:
  • Command. Prints memory usage by the editor script to the console or dump into a specified file.
参数:
Path to a file to dump the information into (optional)
editor_analyze
说明/描 述:
  • Command. Analyzes the performance of the editor script. The information can be printed to the console or dumped into a specified file.
参数:
Path to the log file to dump the log file information into (optional)
editor_disassemble
说明/描 述:
  • Command. Disassembles the editor script. The information can be printed to the console or dumped into a specified file.
参数:
Path to a file to dump the information into (optional)

System Script AnalyzerSystem Script Analyzer#

Operations on the system script debugging.

注意
Available for debug builds only.
system_memory_usage
说明/描 述:
  • Command. Prints memory usage by the system script to the console or dump into a specified file.
参数:
Path to a file to dump the information into (optional)
system_analyze
说明/描 述:
  • Command. Analyzes the performance of the system script. The information can be printed to the console or dumped into a specified file.
参数:
Path to the log file to dump the log file information into (optional)
system_disassemble
说明/描 述:
  • Command. Disassembles the system script. The information can be printed to the console or dumped into a specified file.
参数:
Path to a file to dump the information into (optional)

World Script AnalyzerWorld Script Analyzer#

Operations on the world script debugging.

注意
Available for debug builds only.
world_memory_usage
说明/描 述:
  • Command. Prints memory usage by the world script to the console or dump into a specified file.
参数:
Path to a file to dump the information into (optional)
world_analyze
说明/描 述:
  • Command. Analyzes the performance of the world script. The information can be printed to the console or dumped into a specified file.
参数:
Path to the log file to dump the log file information into (optional)
world_disassemble
说明/描 述:
  • Command. Disassembles the world script. The information can be printed to the console or dumped into a specified file.
参数:
Path to a file to dump the information into (optional)

Script DebuggerScript Debugger#

Operations on the per-function breakpoint. The syntax to set the breakpoint is the following:

源代码
system_breakpoint/world_breakpoint/editor_breakpoint set/remove function_name number_of_arguments
world_breakpoint
说明/描 述:
  • Command. Sets a breakpoint to the specified function in the world script.
The syntax to set the breakpoint is the following:
源代码
world_breakpoint set/remove function_name number_of_arguments
参数:
  1. Name of function
  2. Number of arguments
system_breakpoint
说明/描 述:
  • Command. Sets a breakpoint to the specified function in the system script.
The syntax to set the breakpoint is the following:
源代码
system_breakpoint set/remove function_name number_of_arguments
参数:
  1. Name of function
  2. Number of arguments
editor_breakpoint
说明/描 述:
  • Command. Set a breakpoint to the specified function in the editor script.
The syntax to set the breakpoint is the following:
源代码
editor_breakpoint set/remove function_name number_of_arguments
参数:
  1. Name of function
  2. Number of arguments

Asynchronous OperationsAsynchronous Operations#

Asynchronous operations.

async_log_mode配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值mode for printing the list of asynchronous operations (loading / unloading of images, meshes, files, etc.) related to the specified engine component.
  • 命令。   设置 mode for printing the list of asynchronous operations (loading / unloading of images, meshes, files, etc.) related to the specified engine component.
    注意
    • Available for debug builds only, won't work for release builds.
    • You can specify whether only loading and unloading operations, or all operations should be shown.
参数:
0 - do not print (默认)
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配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值scope of asynchronous operations to be shown via async_log_mode: only loading and unloading operations or all operations.
  • 命令。   设置 scope of asynchronous operations to be shown via async_log_mode: only loading and unloading operations or all operations.
参数:
0 - print only frequently used operations (默认)
1 - print all operations
async_queue_info
说明/描 述:
  • Command. Prints the info on async queue resource count and memory usage.
async_queue_list
说明/描 述:
  • Command. Prints the list of async queue resources.
async_queue_clear
说明/描 述:
  • Command. Clears the async queue.

VisualizerVisualizer#

Operations on the visualizer.

注意
To debug the world and objects in it, the show_visualizer command should be set to 1.
show_visualizer配置文件: *.user
说明/描 述:
  • 变量。   打印当前值visualizer mode.
  • 命令。   设置 visualizer mode. It specifies if the visualizer geometry (bounding volumes, wireframe, physics bodies and shapes, etc.) is shown.
参数:
0 - visualizer is not shown (默认)
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配置文件: *.user
说明/描 述:
  • 变量。   打印当前值FPS counter display mode.
  • 命令。   设置 FPS counter display mode.
参数:
0 - hide the FPS counter (默认)
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配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Reduces wireframe visualizer flickering when TAA is on.
参数:
0 - 关 (默认)
1 -
render_wireframe_antialiasing
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables antialiasing of wireframes.
参数:
0 -
1 - 开 (默认)
render_ffp_antialiasing_lines
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables antialiasing of the Visualizer and other FFP lines.
参数:
0 -
1 - 开 (默认)

World DebuggingWorld Debugging#

Operations on the world debugging.

world_show_spatial配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of the scene spatial tree.
参数:
0 - 关 (默认)
1 -
world_show_visualizer配置文件: *.user
说明/描 述:
  • Variable. Prints the list of node types for which the visualizer is displayed.
  • Command. Sets the node types for which the visualizer is displayed.
参数:
all
world
field
light
decal
object
player
physical
navigation
obstacle
sound
"" - to hide all handlers
render_show_triangles配置文件: *.user
说明/描 述:
  • 变量。   打印当前值wireframe mode for scene triangles.
  • 命令。   设置 wireframe mode for scene triangles.
参数:
0 - triangles are hidden (默认)
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 DebuggingLighting Debugging#

Operations on the lighting debugging.

render_show_lightmap_checker
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   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.
参数:
0 - 关 (默认)
1 -
render_show_voxel_probe_visualizer配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of visualizer for Voxel Probes (shown for the selected probe only).
参数:
0 - 关 (默认)
1 -
render_show_voxel_probe_visualizer_grid_size
说明/描 述:
  • 变量。   打印当前值size of the grid that is used to visualize Voxel Probes (number of spheres along the axis).
  • 命令。   设置 size of the grid that is used to visualize Voxel Probes (number of spheres along the axis).
参数:
[7; 40] - 可用范围
15 - 默认
render_show_voxel_probe_visualizer_sphere_scale
说明/描 述:
  • 变量。   打印当前值scale factor of the sphere that is used to visualize Voxel Probes. The sphere size depends on the scale factor and the voxel size.
  • 命令。   设置 scale factor of the sphere that is used to visualize Voxel Probes. The sphere size depends on the scale factor and the voxel size.
参数:
[0.0f; 1.0f] - 可用范围
0.25f - 默认

Node DebuggingNode Debugging#

Operations on the node debugging.

world_show_handler配置文件: *.user
说明/描 述:
  • Variable. Prints the value indicating if node handlers for lights, particle systems, sectors, portals and so on are displayed.
  • Command. Displays node handlers for lights, particle systems, sectors, portals, etc.
参数:
The node type:
  • all
  • world
  • field
  • light
  • decal
  • object
  • player
  • physical
  • navigation
  • obstacle
  • sound
  • "" - to hide all handlers
world_handler_3d配置文件: *.user
说明/描 述:
  • 变量。   打印当前值world handlers icon type to be used.
  • 命令。   设置 world handlers icon type to be used.
参数:
0 - screen scale (默认)
1 - 3D
world_handler_distance配置文件: *.user
说明/描 述:
  • 变量。   打印当前值world handlers visibility distance.
  • 命令。   设置 world handlers visibility distance.
参数:
[0; inf] - 可用范围
500 - 默认
render_show_decals配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of the wireframe for decals.
参数:
0 - 关 (默认)
1 -
render_show_immovable配置文件: *.user
说明/描 述:
  • 变量。   打印当前值mode for visualization of objects with the Immovable option enabled.
  • 命令。   设置 mode for visualization of objects with the Immovable option enabled.
参数:
0 - displaying of the wireframe is disabled (默认)
1 - displey the wireframes of the objects with the Immovable flag enabled
2 - display the wireframes of the objects with the Immovable flag enabled except for collider objects

Occluder DebuggingOccluder Debugging#

Operations on the occluder debugging.

render_show_occluder配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of the buffer used for occluders shown in the viewport.
参数:
0 - 关 (默认)
1 -

Landscape Terrain DebuggingLandscape Terrain Debugging#

Operations on the Landscape Terrain debugging.

render_show_landscape_albedo配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables visualization of albedo data of a Landscape Terrain.
参数:
0 - 关 (默认)
1 -
render_show_landscape_mask配置文件: *.user
说明/描 述:
  • 变量。   打印当前值visualization of a detail mask of a Landscape Terrain.
  • 命令。   设置 visualization of a detail mask of a Landscape Terrain.
参数:
0 - mask vizualization is disabled (默认)
1 - DetailMask 0
2 - DetailMask 1
3 - ...
4 - DetailMask 19
render_show_landscape_terrain_vt_streaming配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   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.
参数:
0 - 关 (默认)
1 -
render_show_clusters
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the visualizer is displayed for Mesh Cluster objects.
参数:
0 - 关 (默认)
1 -

Physics DebuggingPhysics Debugging#

physics_show_collision_surfaces配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of collision surfaces.
参数:
0 - 关 (默认)
1 -
physics_show_contacts配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of contact points between physical bodies.
参数:
0 - 关 (默认)
1 -
physics_show_joints配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of joints between physical bodies.
参数:
0 - 关 (默认)
1 -
physics_show_shapes配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of collision shapes for physical bodies.
参数:
0 - 关 (默认)
1 -

Occlusion QueriesOcclusion Queries#

render_show_queries配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of occlusion query boxes.
    注意
    Make sure that the Culled by occlusion query flag is set for nodes.
参数:
0 - 关 (默认)
1 -

Performance ProfilingPerformance Profiling#

Operations on the Performance profiler.

show_profiler配置文件: *.user
说明/描 述:
  • 变量。   打印当前值mode for the Performance profiler.
  • 命令。   设置 mode for the Performance profiler.
参数:
0 - profiler information is hidden (默认)
1 - generic profiler information is shown
2 - rendering profiler information is shown
3 - physics profiler information is shown
4 - world profiler information is shown
5 - pathfinding and sound usage profiler information is shown
show_profiler_charts配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of Performance profiler's charts.
参数:
0 -
1 - 开 (默认)

Profiler GUIProfiler GUI#

Operations on the Performance profiler style.

profiler_size配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值size for the profiler font.
  • 命令。   设置 size for the profiler font.
参数:
[4; 32] - 可用范围
13 - 默认
profiler_font配置文件: *.boot
说明/描 述:
  • 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.
参数:
Path to a *.ttf file
core/gui/font.ttf (by default)

MicroprofileMicroprofile#

Operations on the Microprofile.

microprofile_enabled
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables Microprofile.
参数:
0 -
1 - 开 (默认)
microprofile_info
说明/描 述:
  • Command. Prints the Microprofile settings:
    • Maximum number of frames that can be profiled
    • Number of dump frames
    • Flag indicating if GPU profiling is enabled
    • Web server status
    • Web server port
    • Number of webserver frames
    If the application is compiled without Microprofile, the corresponding message will be printed to the console.
microprofile_webserver_frames配置文件: *.user
说明/描 述:
  • 变量。   打印当前值number of frames to be visualised in your Web browser.
  • 命令。   设置 number of frames to be visualised in your Web browser.
参数:
[1; 500] - 可用范围
200 - 默认
microprofile_dump_frames配置文件: *.user
说明/描 述:
  • 变量。   打印当前值number of frames to be included in the Microprofile dump.
  • 命令。   设置 number of frames to be included in the Microprofile dump.
参数:
[1; 500] - 可用范围
500 - 默认
microprofile_dump_html
说明/描 述:
  • 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.
参数:
Path to an .html file.

Video SettingsVideo Settings#

video_adapter配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值the hardware video adapter ID to be used for rendering.
  • 命令。   设置 the hardware video adapter ID to be used for rendering. The value must be from 0 to the number of available video adapters.
    注意
    Available only during the Engine initialization (startup), has no effect at run time.
参数:
[0; 32] - 可用范围
0 - 默认
video_debug配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值video debug mode for graphical API.
  • 命令。   设置 video debug mode for graphical API.
    注意
    Beware of severe slowdown when enabled. Available only during the Engine initialization (startup), has no effect at run time.
参数:
0 - release rendering context (no debug) (默认)
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)
show_displays
说明/描 述:
  • Command. Prints the information about all available displays.
show_display_modes
说明/描 述:
  • Command. Prints the information about all available modes for the specified display.
参数:
Index of the display for which modes are to be displayed (0 - by default).

Main Window Resolution and FullscreenMain Window Resolution and Fullscreen#

Operations on main window options adjustment (size, fullscreen mode, borders, restart, etc.).

video_offscreen配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   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).
    注意
    Available only during the Engine initialization (startup), has no effect at run time.
参数:
0 - 关 (默认)
1 -
main_window配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   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.
    注意
    Available only during the Engine initialization (startup), has no effect at run time.
参数:
0 -
1 - 开 (默认)
main_window_size配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值size of the main application window.
  • 命令。   设置 size of the main application window.
参数:
Usage with the argument:
main_window_size width height
(1600 x 900 by default)
main_window_resizable配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables the resizable mode for the main application window (its size can be changed on the fly without restarting the application).
参数:
0 -
1 - 开 (默认)
main_window_fullscreen配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值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).
  • 命令。   设置 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).
参数:
0 - windowed mode (默认)
1 - full-screen mode
main_window_fullscreen_display配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值display on which to show the main application window in fullscreen mode.
  • 命令。   设置 display on which to show the main application window in fullscreen mode.
参数:
0 - Main - display set as main in OS settings. (默认)
1 - Current - display that currently has focus (where the mouse cursor is).
main_window_fullscreen_display_mode配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值display mode (resolution and frequency) for the application window to be shown in fullscreen mode.
  • 命令。   设置 display mode (resolution and frequency) for the application window to be shown in fullscreen mode.
参数:
0 - Desktop - use display mode mode currently selected on the user's computer. (默认)
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).
注意
In case such mode does not exist (a corresponding error message is displayed), switch to the Desktop mode.

main_window_auto_restart配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables automatic reopening of the main application window after changing its settings (fullscreen mode, borders, size, etc.). Can be disabled, when necessary, to control main window restart manually via the restart_main_window command.
参数:
0 -
1 - 开 (默认)
main_window_borders配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables drawing the borders of the main application window. In some cases it might be necessary to render the window in borderless mode.
参数:
0 -
1 - 开 (默认)
restart_main_window
说明/描 述:

Graphics SettingsGraphics Settings#

Operations on the graphics adjustment.

render_vsync配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值vertical FPS synchronization.
  • 命令。   设置 vertical FPS synchronization.
参数:
0 - not to synchronize FPS (默认)
1 - synchronize FPS
2 - enable adaptive vertical sync

Multi-Monitor and Stereo RenderingMulti-Monitor and Stereo Rendering#

video_quad_buffer配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables quad buffered stereo.
    注意
    Available only during the Engine initialization (startup), has no effect at run time.
参数:
0 - 关 (默认)
1 -

Rendering SettingsRendering Settings#

Operations on the renderer.

textures_reload
说明/描 述:
  • Command. Reloads all render textures.
render_streaming_reload
说明/描 述:
  • Command. Reloads all rendering resources. You can specify an optional argument to reload resources selectively.

Usage with the argument: render_streaming_reload [mesh/texture]
参数:
none - reloads all resources
mesh - reload only meshes
texture - reload only textures

Rendering ResourcesRendering Resources#

Operations representing information on the rendering resources.

render_budget
说明/描 述:
  • 变量。   打印当前值render budget value, in seconds, which limits the number of loaded/created graphics resources during a frame according to loading/creation time.
  • 命令。   设置 render budget value, in seconds, which limits the number of loaded/created graphics resources during a frame according to loading/creation time.
参数:
[0.0f; inf] - 可用范围
1/60 - 默认
render_streaming_info
说明/描 述:
  • Command. Prints general information (the number of registered/loaded resources; memory used) on rendering resources:
    1. Mesh - loaded meshes
    2. MeshSkinned - skinned meshes
    3. MeshDynamic - dynamic meshes stored in the memory rather than on disk
    4. TextureManaged - images loaded into the memory; if image is not fully loaded, a dummy texture or a mipmap texture is used
    5. TextureStream - streamed images
render_streaming_list
说明/描 述:
  • Command. Prints the list of loaded resources and detailed information regarding:
    1. Meshes, MeshSkinned and MeshDynamic with used memory
    2. TextureManaged (textures loaded into memory at once) and TextureStream (textures streamed on demand) with texture format, used compression, if any, texture dimensions and size (available only for already loaded textures).
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_streaming_max_threads
说明/描 述:
  • 变量。   打印当前值maximum number of threads used for streaming.
  • 命令。   设置 maximum number of threads used for streaming. Higher number of threads results in faster streaming, but may cause spikes in case of excessive consumption of GPU resources.
参数:
[1; 256] - 可用范围
1 - 默认
render_streaming_textures_cache_resolution
说明/描 述:
  • 变量。   打印当前值resolution for texture cache elements.
  • 命令。   设置 resolution for texture cache elements. These minimized copies of textures are used instead of the originals while the latter are loaded.
参数:
0 - 8x8
1 - 16x16 (默认)
2 - 32x32
3 - 64x64
4 - 128x128
5 - 256x256
6 - 512x512
render_streaming_textures_memory_limit
说明/描 述:
  • 变量。   打印当前值cache memory limit used for textures streaming.
  • 命令。   设置 cache memory limit used for textures streaming. This is a recommended value to aim for. So, it can be exceeded if textures are required to render the current frame. The memory limit is associated with the lifetime: textures are deleted from video memory only when both values are exceeded.
参数:
[0; 100] - 可用范围
65 - 默认
textures_cache_preload配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables preloading of the texture cache at engine startup.
    注意
    Textures cache always remains in memory after loading.
参数:
0 -
1 - 开 (默认)
render_streaming_textures_reload
说明/描 述:
  • Command. Reloads all textures.
render_streaming_textures_cache_create
说明/描 述:
  • Command. Generates texture cache for all textures used in the project.
    注意
    Generated textures cache is incomplete, only images are created, as all metadata (flags, etc.) is stored in materials.
render_streaming_textures_cache_destroy
说明/描 述:
  • Command. Clears texture cache (images and metadata) stored on disk. All files in the data/.cache_textures will be removed.
render_streaming_textures_cache_load
说明/描 述:
  • Command. Loads texture cache from the disk. Texture cache always remains in memory after loading.
render_streaming_textures_cache_unload
说明/描 述:
  • Command. Unloads texture cache from the memory. This method does not delete files in the data/.cache_textures.
render_streaming_particles_memory_limit
说明/描 述:
  • 变量。   打印当前值cache memory limit for vertices of particle systems, in percentage of the total GPU memory.
  • 命令。   设置 cache memory limit for vertices of particle systems, in percentage of the total GPU memory.
    注意
    Setting a too low limit for a huge number of particle systems in the scene may lead to rendering only some of them.
参数:
[0; 100] - 可用范围
3 - 默认
说明/描 述:

Rendering Resources: OpenGL-Specific CommandsRendering Resources: OpenGL-Specific Commands#

Operations representing information on the rendering resources for OpenGL.

注意
OpenGL API only.
gl_async_buffer配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值size of an intermediate buffer (between the CPU and new resource) used for streaming, in Mb.
  • 命令。   设置 size of an intermediate buffer (between the CPU and new resource) used for streaming, in Mb.
    注意
    • The size of this buffer must be equal to the size of the largest resource (mesh/texture), otherwise in case of a larger resource, the buffer will be resized causing a spike.
    • Be aware, that the size of this intermediate buffer will be added to total memory consumption.
参数:
[0; 1024] - 可用范围
128 - 默认
gl_async_buffer_indices配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值size of an intermediate buffer used for mesh streaming (to store vertex indices of meshes), in Mb.
  • 命令。   设置 size of an intermediate buffer used for mesh streaming (to store vertex indices of meshes), in Mb.
参数:
[0; 256] - 可用范围
16 - 默认
gl_async_buffer_synchronization配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables buffer synchronization for transferring data from the streaming thread to the main one.
    注意
    When enabled, async buffers are created only once and then synchronized reducing the time on allocating and freeing memory. When disabled, both async buffer and async buffer for indices are created anew. This reduces the number of buffer synchronizations but increases the number of memory allocations. Sometimes (depending on the hardware/driver used, e.g. when the main thread is affected by sychronization primitives in other threads) memory allocation may be faster than synchronizations, in such cases, when streaming becomes unacceptably slow, it is recommended to disable buffer synchronization.
参数:
0 -
1 - 开 (默认)
gl_use_debug_info配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables debug info usage.
    注意
    Available for debug builds only.
参数:
0 - 关 (默认)
1 -
gl_terrain_use_async
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables asynchronous loading of Landscape Terrain tiles.
    注意
    When disabled, it may reduce performance spikes on certain AMD and Intel GPUs at the cost of the loading speed.
参数:
0 -
1 - 开 (默认)
gl_terrain_waiting_frames
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Set the number of frames to wait for streaming Landscape Terrain tiles. Increase this value (4-16 frames) to avoid more performance spikes and slightly improve the loading speed by forcing deferred data loading that imitates asynchronous data streaming without synchronization points.
参数:
0 -
1 - 开 (默认)

Rendering BuffersRendering Buffers#

Rendering Buffer InfoRendering Buffer Info#

Operations representing information on the rendering buffers.

render_info
说明/描 述:
  • 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
说明/描 述:
  • Command. Print the detailed list of render buffers, with texture size, format and used space.

Rendering Buffer DebuggingRendering Buffer Debugging#

Operations on the rendering buffer debugging.

render_show_textures配置文件: *.
说明/描 述:
  • 变量。   打印当前值display mode for texture buffers used by the renderer.
  • 命令。   设置 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).
参数:
0 - all buffers are hidden (默认)
1 - show render textures (compact)
2 - show render textures (full)
render_screen_precision
说明/描 述:
  • 变量。   打印当前值value indicating the current screen precision.
  • 命令。   设置 value indicating the current screen precision. This parameter determines the texture format used for screen HDR buffers.
参数:
0 - RG11B10F
1 - RGBA16F (默认)
render_show_textures_number配置文件: *.
说明/描 述:
  • 变量。   打印当前值number of buffers in a row and column displayed in the full view mode (请参阅render_show_textures).
  • 命令。   设置 number of buffers in a row and column displayed in the full view mode (请参阅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.
参数:
[0; 16] - 可用范围
7 - 默认
render_show_textures_offset配置文件: *.
说明/描 述:
  • 变量。   打印当前值number of the buffer to start displaying from in the full view mode (请参阅render_show_textures).
  • 命令。   设置 number of the buffer to start displaying from in the full view mode (请参阅render_show_textures).
参数:
[0; 256] - 可用范围
0 - 默认

Rendering PassesRendering Passes#

Operations on rendering passes.

render_debug
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 - 关 (默认)
1 -
render_depth_pre_pass
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
    注意
    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 to make sure that a positive effect is obtained.
参数:
0 - 关 (默认)
1 -
render_show_scissors配置文件: *.
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if scissor rectangles are displayed.
参数:
0 - 关 (默认)
1 -
render_show_ambient配置文件: *.
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the ambient pass buffer is displayed.
参数:
0 - 关 (默认)
1 -
render_show_alpha_test配置文件: *.
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the visualizer is displayed for transparent objects using alpha test.
参数:
0 - 关 (默认)
1 -
render_show_transparent配置文件: *.
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the visualizer is displayed for transparent objects.
参数:
0 - 关 (默认)
1 -
render_clouds_enabled
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of clouds is enabled.
参数:
0 -
1 - 开 (默认)
render_lights_enabled
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of lights is enabled.
参数:
0 -
1 - 开 (默认)
render_water_enabled
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of water is enabled.
参数:
0 -
1 - 开 (默认)
render_screen_space_effects
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of screen-space effects is enabled.
参数:
0 -
1 - 开 (默认)
render_transparent_enabled
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the transparent pass is rendered.
    注意
    This option takes effect only when the forward rendering pass is used for transparent objects rendering.
参数:
0 -
1 - 开 (默认)
render_transparent_ambient
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the transparent ambient pass is rendered.
    注意
    This option takes effect only when the forward rendering pass is used for transparent objects rendering.
参数:
0 -
1 - 开 (默认)
render_transparent_light
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the transparent light pass is rendered.
    注意
    This option takes effect only when the forward rendering pass is used for transparent objects rendering.
参数:
0 -
1 - 开 (默认)
render_transparent_deferred
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the deferred pass for transparent objects is enabled.
    注意
    This option takes effect only when the forward rendering pass is used for transparent objects rendering.
参数:
0 -
1 - 开 (默认)
render_transparent_multiple_env_probes
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the transparent multiple environment probes pass is rendered.
    注意
    This method takes effect only when the forward rendering pass is used for transparent objects rendering.
参数:
0 -
1 - 开 (默认)

MeshesMeshes#

Operations on mesh rendering.

render_alpha_fade
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if alpha-blend fading (dithering) is enabled for objects. When the feature is enabled, objects LODs are smoothly blended into each other over a fade distance.
参数:
0 -
1 - 开 (默认)
render_show_mesh_dynamics
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the visualizer is displayed for dynamic meshes.
参数:
0 - 关 (默认)
1 -
render_show_mesh_statics
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the visualizer is displayed for static meshes.
参数:
0 - 关 (默认)
1 -

TessellationTessellation#

Operations on mesh tessellation.

render_tessellation_density_multiplier
说明/描 述:
  • 变量。   打印当前值global Density multiplier for the adaptive hardware-accelerated tessellation.
  • 命令。   设置 global Density multiplier for the adaptive hardware-accelerated tessellation. Higher values produce denser meshes.
参数:
[0.0f; 10.0f] - 可用范围
1.0f - 默认
render_tessellation_distance_multiplier
说明/描 述:
  • 变量。   打印当前值global multiplier for all distance parameters of the adaptive hardware-accelerated tessellation used for distance-dependent optimization.
  • 命令。   设置 global multiplier for all distance 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).
参数:
[0.0f; 10.0f] - 可用范围
1.0f - 默认
render_tessellation_shadow_density_multiplier
说明/描 述:
  • 变量。   打印当前值global Shadow Density multiplier for the Tessellated Displacement effect.
  • 命令。   设置 global Shadow Density multiplier for the Tessellated Displacement effect. Higher values produce more detailed shadows. You can make shadows from tessellated meshes simpler to save performance.
参数:
[0.01f; 10.0f] - 可用范围
1.0f - 默认

DecalsDecals#

Operations on decal rendering.

render_decals
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of decals is enabled.
参数:
0 -
1 - 开 (默认)

FieldsFields#

Operations on field rendering.

render_field_height_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the texture into which all textures set for all FieldHeight objects are rendered.
  • 命令。   设置 resolution of the texture into which all textures set for all FieldHeight objects are rendered.
    注意
    Increased resolution significantly affects performance.
参数:
0 - 128 x 128
1 - 256 x 256
2 - 512 x 512 (默认)
3 - 1024 x 1024
4 - 2048 x 2048
5 - 4096 x 4096
6 - 8192 x 8192
render_field_precision
说明/描 述:
  • 变量。   打印当前值value indicating the precision of textures used for field objects.
  • 命令。   设置 value indicating the precision of textures used for field objects. Either of the following:
    • 16-bit precision R16 texture
    • 32-bit precision R32F texture
参数:
0 - 16 bit (默认)
1 - 32 bit
render_field_shoreline_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the texture into which all textures set for all FieldShoreline objects are rendered.
  • 命令。   设置 resolution of the texture into which all textures set for all FieldShoreline objects are rendered.
    注意
    Increased resolution significantly affects performance.
参数:
0 - 128x128 (默认)
1 - 256x256
2 - 512x512
3 - 1024x1024
4 - 2048x2048
5 - 4096x4096
6 - 8192x8192

TexturesTextures#

Operations on texture rendering.

render_textures_quality
说明/描 述:
  • 变量。   打印当前值resolution of textures.
  • 命令。   设置 resolution of textures.
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
默认值为 (2)
render_textures_max_resolution
说明/描 述:
  • 变量。   打印当前值maximum resolution of all textures.
  • 命令。   设置 maximum resolution of all textures. the engine doesn't compress existing textures: it uses specified mipmaps of *.dds textures.
参数:
0 - 128x128
1 - 256x256
2 - 512x512
3 - 1024x1024
4 - 2048x2048
5 - 4096x4096
6 - 8192x8192 (默认)
7 - 16384x16384
render_textures_min_resolution
说明/描 述:
  • 变量。   打印当前值minimum resolution of all textures.
  • 命令。   设置 minimum resolution of all textures. The Engine doesn't compress existing textures: it uses specified mip maps of *.dds textures.
参数:
0 - 128x128 (默认)
1 - 256x256
2 - 512x512
3 - 1024x1024
4 - 2048x2048
5 - 4096x4096
6 - 8192x8192
7 - 16384x16384
render_textures_filter
说明/描 述:
  • 变量。   打印当前值texture filtering mode.
  • 命令。   设置 texture filtering mode.
参数:
0 - Bilinear
1 - Trilinear (默认)
render_textures_anisotropy
说明/描 述:
  • 变量。   打印当前值anisotropy level for textures (degree of anisotropic filtering).
  • 命令。   设置 anisotropy level for textures (degree of anisotropic filtering).
参数:
0 - level 1
1 - level 2
2 - level 4
3 - level 8 (默认)
4 - level 16

ShadersShaders#

Operations on shaders.

render_defines
说明/描 述:
  • Command. Print the macros list related to the renderer (defines to make corresponding resources available in shaders).

Shader CompilationShader Loading#

Operations on the shader loading.

说明/描 述:

Effects and PostprocessesEffects and Postprocesses#

Operations on the effects and postprocesses.

render_animation_leaf
说明/描 述:
  • 变量。   打印当前值global scale for rotation angle of vegetation leaves.
  • 命令。   设置 global scale for rotation angle of vegetation leaves.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_animation_scale
说明/描 述:
  • 变量。   打印当前值global scale for rotation speed of vegetation leaves.
  • 命令。   设置 global scale for rotation speed of vegetation leaves.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_animation_stem
说明/描 述:
  • 变量。   打印当前值global scale for movement amplitude of vegetation stems.
  • 命令。   设置 global scale for movement amplitude of vegetation stems.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_animation_wind
说明/描 述:
  • 变量。   打印当前值direction of wind for all vegetation (grass and trees).
  • 命令。   设置 direction of wind for all vegetation (grass and trees). It is a multiplier for the stem offset (in grass, stem and leaves materials).
参数:
(0.0f, 0.0f, 0.0f) - default value
render_auxiliary
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if auxiliary render buffer is used. The buffer should be enabled for render and post post-processes to work.
参数:
0 -
1 - 开 (默认)
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_bent_normal_fix_overlit_areas
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if correction of overlit areas for bent normals calculation is enabled.
    注意
    • 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) is enabled.
注意
如果您通过使用设置值 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_bent_normal_preset). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
说明/描 述:
说明/描 述:
说明/描 述:
render_bloom
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the Bloom effect is enabled.
参数:
0 - 关 (默认)
1 -
render_bloom_passes
说明/描 述:
  • 变量。   打印当前值number of passes for the bloom effect.
  • 命令。   设置 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.
    注意
    The higher the value, the smoother the effect is. However, this option significantly affects performance.
参数:
[2; 8] - 可用范围
6 - 默认
render_bloom_power
说明/描 述:
  • 变量。   打印当前值power of the Bloom effect.
  • 命令。   设置 power of the Bloom effect.
    • 0.0f (min) - the Bloom effect is blurred.
    • 1.0f (max) - the Bloom effect is more contrast.
参数:
[0.0f; 1.0f] - 可用范围
0.7f - 默认
render_bloom_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the Bloom effect.
  • 命令。   设置 resolution of the Bloom effect.
参数:
0 - quarter
1 - half
2 - full (默认)
render_bloom_scale
说明/描 述:
  • 变量。   打印当前值scale of the Bloom effect.
  • 命令。   设置 scale of the Bloom effect.
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_border
说明/描 述:
  • 变量。   打印当前值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.
  • 命令。   设置 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.
    注意
    Increasing the width of the border may increase performance costs.
参数:
(0, 0) - default value
render_camera_effects_threshold
说明/描 述:
  • 变量。   打印当前值brightness threshold, which is used to detect if an object should be blurred in the HDR mode.
  • 命令。   设置 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.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_camera_effects_temporal_filtering
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 - 关 (默认)
1 -
render_camera_effects_temporal_filtering_color_clamping_intensity
说明/描 述:
参数:
[1.0f; inf] - 可用范围
3.0f - 默认
render_camera_effects_temporal_filtering_min_velocity_clamping
说明/描 述:
  • 变量。   打印当前值sensitivity of TAA color clamping for the Bloom effect for static objects.
  • 命令。   设置 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) values: higher values reduce ghosting, but at the same time reduce the temporal filter effect.
    注意
    This option is available only when the temporal filtering (请参阅render_camera_effects_temporal_filtering) is enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.05f - 默认
render_camera_effects_temporal_filtering_max_velocity_clamping
说明/描 述:
  • 变量。   打印当前值sensitivity of TAA color clamping for the Bloom effect for moving objects.
  • 命令。   设置 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) values: higher values reduce ghosting, but at the same time reduce the temporal filter effect.
    注意
    This option is available only when the temporal filtering (请参阅render_camera_effects_temporal_filtering) is enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.1f - 默认
render_chromatic_aberration
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of the 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.
参数:
0 - 关 (默认)
1 -
render_chromatic_aberration_intensity
说明/描 述:
  • 变量。   打印当前值intensity (strength) of the Chromatic Aberration post-effect.
  • 命令。   设置 intensity (strength) of the Chromatic Aberration post-effect. Controls how much color shifting occurs.
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_chromatic_aberration_noise_intensity
说明/描 述:
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_chromatic_aberration_samples
说明/描 述:
  • 变量。   打印当前值number of samples used for calculation of the Chromatic Aberration post-effect.
  • 命令。   设置 number of samples used for calculation of the Chromatic Aberration post-effect. Higher values reduce banding making the effect look smoother.
参数:
[1; 32] - 可用范围
1 - 默认
render_dirt_scale
说明/描 述:
  • 变量。   打印当前值intensity of lens dirt effect modulating the pattern of lens flares defined by the Dirt Texture.
  • 命令。   设置 intensity of lens dirt effect modulating the pattern of lens flares defined by the Dirt Texture. For example, it can be used to create an effect of unclean optics when the camera looks at the sun.
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_dof
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the DOF (Depth Of Field) effect is enabled.
参数:
0 - 关 (默认)
1 -
render_dof_preset
说明/描 述:
  • 变量。   打印当前值DoF effect quality preset. To customize the DoF effect options at run time you should activate the Custom preset:
  • 命令。   设置 DoF effect quality preset. To customize the DoF effect options at run time you should activate the Custom preset:
参数:
0 - Very Low (默认)
1 - Low
2 - Medium
3 - High
4 - Ultra
5 - Extreme
6 - Custom
render_dof_blur
说明/描 述:
  • 变量。   打印当前值intensity of blur for the DOF (Depth Of Field) effect.
  • 命令。   设置 intensity of blur for the DOF (Depth Of Field) effect.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_dof_chromatic_aberration
说明/描 述:
参数:
[0.0f; inf] - 可用范围
0.0f - 默认
render_dof_far_distance
说明/描 述:
  • 变量。   打印当前值far DOF limit of the camera: the distance between the camera and the furthest element that is considered to be acceptably sharp.
  • 命令。   设置 far DOF limit of the camera: the distance between the camera and the furthest element that is considered to be acceptably sharp. Black zone on the DOF mask means in-focus zone.
参数:
[0.0f; inf] - 可用范围
10.0f - 默认
render_dof_near_distance
说明/描 述:
  • 变量。   打印当前值near DOF limit of the camera: the distance between the camera and the first element that is considered to be acceptably sharp.
  • 命令。   设置 near DOF limit of the camera: the distance between the camera and the first element that is considered to be acceptably sharp. Black zone on the DOF mask means in-focus zone.
参数:
[0.0f; inf] - 可用范围
10.0f - 默认
render_dof_focal_distance
说明/描 述:
  • 变量。   打印当前值focal distance of the camera, i.e. a point where objects are in-focus and visible clearly.
  • 命令。   设置 focal distance of the camera, i.e. a point where objects are in-focus and visible clearly.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_dof_far_focal_offset
说明/描 述:
  • 变量。   打印当前值Sets the offset from the focal to the farthest blurred zone for the DOF effect.
  • 命令。   设置 Sets the offset from the focal to the farthest blurred zone for the DOF effect. In other words, the distance when background (far) is in focus.
参数:
[0.0f; inf] - 可用范围
0.0f - 默认
render_dof_near_focal_offset
说明/描 述:
  • 变量。   打印当前值offset from the focal to the nearest blurred zone.
  • 命令。   设置 offset from the focal to the nearest blurred zone. In other words, the distance when foreground (near) is in focus.
参数:
[0.0f; inf] - 可用范围
0.0f - 默认
render_dof_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the DOF (Depth Of Field) effect.
  • 命令。   设置 resolution of the DOF (Depth Of Field) effect.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - quarter
1 - half
2 - full (默认)
render_dof_quality
说明/描 述:
  • 变量。   打印当前值quality of the DOF (Depth Of Field) effect.
  • 命令。   设置 quality of the DOF (Depth Of Field) effect.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_dof_bokeh_mode
说明/描 述:
  • 变量。   打印当前值shape of the Bokeh for the DOF effect.
  • 命令。   设置 shape of the Bokeh for the DOF effect. This parameter determines the way the lens renders out-of-focus points of light.
    注意
    For the DOF effect, the Bokeh effect is enabled by default.
参数:
0 - ring (默认)
1 - circle
render_dof_increased_accuracy
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the increased accuracy option is enabled for the DOF (Depth Of Field) effect. When enabled, focusing calculation is performed with increased accuracy.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_dof_focus_improvement
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 -
render_exposure_mode
说明/描 述:
参数:
0 - static (默认)
1 - logarithmic adaptive exposure
2 - quadratic adaptive exposure
render_exposure
说明/描 述:
  • 变量。   打印当前值camera exposure (a multiplier of the scene luminance and brightness).
  • 命令。   设置 camera exposure (a multiplier of the scene luminance and brightness).

    It determines the resulting amount of luminance:

    • 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.
    Available only when the Camera Mode (请参阅render_camera_mode) is set to Classic.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_exposure_adaptation
说明/描 述:
  • 变量。   打印当前值time for the camera to adjust exposure, in seconds.
  • 命令。   设置 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.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_iso
说明/描 述:
  • 变量。   打印当前值ISO value used for static exposure calculation.
  • 命令。   设置 ISO value used for static exposure calculation. This value is available for the physically-based camera (请参阅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.
参数:
[0; inf] - 可用范围
100 - 默认
render_shutter_speed
说明/描 述:
  • 变量。   打印当前值shutter speed used for static exposure calculation.
  • 命令。   设置 shutter speed used for static exposure calculation. This setting is available for the physically-based camera (请参阅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.
参数:
[0; inf] - 可用范围
250 - 默认
render_f_stop
说明/描 述:
  • 变量。   打印当前值f-stop value used for static exposure calculation.
  • 命令。   设置 f-stop value used for static exposure calculation. This setting is available for the physically-based camera (请参阅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.
参数:
[0; inf] - 可用范围
11 - 默认
render_camera_mode
说明/描 述:
  • 变量。   打印当前值camera mode, which determines the way the exposure is set.
  • 命令。   设置 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), shutter speed (请参阅render_shutter_speed), F-stop (请参阅render_f_stop). With the default values of these parameters, the static exposure value is near 1.
      注意
      For the physically-based mode, the 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).
参数:
0 - classic (默认)
1 - physically-based
render_white_balance
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if automatic white balance correction is enabled.
参数:
0 -
1 - 开 (默认)
render_white_balance_intensity
说明/描 述:
  • 变量。   打印当前值value of white balance correction intensity.
  • 命令。   设置 value of white balance correction intensity.
    • 0.0f - no white balance correction is performed.
    • higher values result in stronger correction.
    注意
    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; 1.0f] - 可用范围
0.3f - 默认
render_white_balance_adaptation_time
说明/描 述:
  • 变量。   打印当前值time period set for the camera to adjust white balance.
  • 命令。   设置 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).
    注意
    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).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_vignette_mask
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of the Vignette Mask 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.
参数:
0 - 关 (默认)
1 -
render_vignette_mask_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the Vignette Mask.
  • 命令。   设置 intensity of the Vignette Mask. Defines the amount of vignetting on the screen: higher values moke the vignette wider.
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_vignette_mask_power
说明/描 述:
  • 变量。   打印当前值Power value that controls mask opacity for the Vignette Mask post-effect.
  • 命令。   设置 Power value that controls mask opacity for the Vignette Mask post-effect.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_noise
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of the Noise post-effect is enabled.
参数:
0 - 关 (默认)
1 -
render_noise_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the Noise post-effect.
  • 命令。   设置 intensity of the Noise post-effect. Higher values result in more noise applied to the image.
参数:
[0.0f; inf] - 可用范围
0.03f - 默认
color_correction_brightness
说明/描 述:
  • 变量。   打印当前值overall brightness value for the scene.
  • 命令。   设置 overall brightness value for the scene.
参数:
[-1.0f; 1.0f] - 可用范围
0.0f - 默认
color_correction_contrast
说明/描 述:
  • 变量。   打印当前值overall contrast value for the scene.
  • 命令。   设置 overall contrast value for the scene.
参数:
[-1.0f; 1.0f] - 可用范围
0.0f - 默认
color_correction_gamma
说明/描 述:
  • 变量。   打印当前值Gamma correction value for the scene.
  • 命令。   设置 Gamma correction value for the scene.
参数:
[0.5f; 1.5f] - 可用范围
1.0f - 默认
color_correction_white
说明/描 述:
  • 变量。   打印当前值white balance of the scene.
  • 命令。   设置 white balance of the scene.
参数:
vec4_zero - default value (black)
color_correction_by_curves
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if color correction via curves is enabled.
参数:
0 -
1 - 开 (默认)
color_correction_hue_per_color
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if fine-adjustment of hue (color shift) for each of the 12 major colors of the spectre is enabled.
参数:
0 -
1 - 开 (默认)
color_correction_hue_shift
说明/描 述:
  • 变量。   打印当前值hue adjustment values for the scene.
  • 命令。   设置 hue adjustment 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.
参数:
(0,0,0,0,0,0,0,0,0,0,0,0) - default value
color_correction_saturation_per_color
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if fine-adjustment of saturation for each of the 12 major colors of the spectre is enabled.
参数:
0 -
1 - 开 (默认)
color_correction_saturation
说明/描 述:
  • 变量。   打印当前值saturation adjustment values for the scene.
  • 命令。   设置 saturation adjustment 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.
参数:
(1,1,1,1,1,1,1,1,1,1,1,1) - default value
color_correction_preserve_saturation
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if initial scene color saturation is to be preserved after applying color correction.
参数:
0 - 关 (默认)
1 -
render_supersampling
说明/描 述:
  • 变量。   打印当前值number of samples per pixel used for supersampling.
  • 命令。   设置 number of samples per pixel used for supersampling.
参数:
[1e-6f; 8.0f] - 可用范围
1.0f - 默认
render_occluders
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of occluders is enabled.
参数:
0 -
1 - 开 (默认)
render_occluders_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the texture, to which occluders (请参阅render_occluders) are rendered.
  • 命令。   设置 resolution of the texture, to which occluders (请参阅render_occluders) are rendered.
参数:
From 1x1 to 1024x1024 Default: 128x64
render_occluders_shadows
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether rendering of occluders for shadows is enabled.
参数:
0 - 关 (默认)
1 -
render_occluders_shadows_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the texture, to which occluders for shadows (请参阅render_occluders_shadows) are rendered.
  • 命令。   设置 resolution of the texture, to which occluders for shadows (请参阅render_occluders_shadows) are rendered.
参数:
From 1x1 to 1024x1024 Default: 512x512
说明/描 述:
render_ssgi
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the SSGI (Screen Space Global Illumination) effect is enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_ssgi_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the SSGI (Screen Space Global Illumination) for the scene.
  • 命令。   设置 intensity of the SSGI (Screen Space Global Illumination) for the scene. By the minimum value of 0.0f, the global illumination is the darkest.
注意
如果您通过使用设置值 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_ssgi_preset). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssgi_intensity_boost
说明/描 述:
  • 变量。   打印当前值boost intensity value.
  • 命令。   设置 boost intensity value. Increases the SSGI intensity by raising the value to the specified power.
注意
如果您通过使用设置值 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_ssgi_preset). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - power of 1 (默认)
1 - power of 2
2 - power of 3
3 - power of 4
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_ssgi_threshold
说明/描 述:
  • 变量。   打印当前值threshold value for the ray-traced SSGI (Screen Space Global Illumination).
  • 命令。   设置 threshold value for the ray-traced SSGI (Screen Space Global Illumination).
    注意
    Ray-traced SSGI calculation available only when the SSRTGI technique (请参阅render_ssrtgi_preset) is enabled.
注意
如果您通过使用设置值 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_ssgi_preset). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_fxaa
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if FXAA (post-process anti-aliasing) is enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_fxaa_intensity
说明/描 述:
  • 变量。   打印当前值intensity of FXAA.
  • 命令。   设置 intensity of FXAA. Intensity specifies the sample offset of FXAA fragment. The higher the value, the more blurred image will be.
参数:
[0.0f; 1.0f] - 可用范围
0.0f - 默认
render_aa_preset
说明/描 述:
  • 变量。   打印当前值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:
  • 命令。   设置 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:
参数:
0 - Sharpest (默认)
1 - Sharp
2 - Smooth
3 - Smooth + SRAA
4 - Smoothest
5 - Smoothest + SRAA
6 - VR Mode
7 - Custom
render_taa
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if TAA (Temporal Anti-Aliasing) is enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_taa_preset
说明/描 述:
  • 变量。   打印当前值TAA (Temporal Anti-Aliasing) preset used at the moment. To customize Anti-Aliasing options at run time you should activate the Custom preset:
  • 命令。   设置 TAA (Temporal Anti-Aliasing) preset used at the moment. To customize Anti-Aliasing options at run time you should activate the Custom preset:
参数:
0 - Sharpest (默认)
1 - Sharp
2 - Smooth
3 - Smoothest
4 - VR Mode
5 - Custom
render_taa_antialiasing_in_motion
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if improved anti-aliasing in motion (for moving camera and objects) is enabled. TAA (请参阅render_taa) must be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_taa_frame_count
说明/描 述:
  • 变量。   打印当前值frame count of TAA (Temporal Anti-Aliasing).
  • 命令。   设置 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) is disabled.
参数:
[0.0f; inf] - 可用范围
30.0f - 默认
render_taa_catmull_resampling
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_taa_frames_by_color
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if 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) must be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_taa_diagonal_neighbors
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_taa_preserve_details
说明/描 述:
  • 变量。   打印当前值detail level of TAA (Temporal Anti-Aliasing).
  • 命令。   设置 detail level of TAA (Temporal Anti-Aliasing). The higher the value, the more detailed the image is. Can produce additional flickering.
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_taa_pixel_offset
说明/描 述:
  • 变量。   打印当前值size of the sample offset performed during subpixel jittering.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_taa_samples
说明/描 述:
  • 变量。   打印当前值number of the sample offsets performed during subpixel jittering.
  • 命令。   设置 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) must be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 1 sample offset, no anti-aliasing
1 - 4 offsets (默认)
2 - 8 offsets
3 - 16 offsets
render_taa_max_frames_by_velocity
说明/描 述:
  • 变量。   打印当前值maximum frame count of TAA (Temporal Anti-Aliasing).
  • 命令。   设置 maximum frame count of TAA (Temporal Anti-Aliasing). Specifies the maximum number of frames in the velocity buffer combined for pixels that don't move relative to the screen space.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
60.0f - 默认
render_taa_min_frames_by_velocity
说明/描 述:
  • 变量。   打印当前值minimum frame count of TAA (Temporal Anti-Aliasing).
  • 命令。   设置 minimum frame count of TAA (Temporal Anti-Aliasing). Specifies the minimum number of frames in the velocity buffer combined for fast moving pixels on the screen.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
4.0f - 默认
render_taa_frames_by_velocity
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the TAA velocity clamping option is enabled. This option controls the number of frames combined for pixels depending on the velocity in the fragment: the number of frames is clamped to the [Min frame count; Max frame count]. It reduces blurring in dynamic scenes with a lot of moving objects.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_taa_frames_velocity_threshold
说明/描 述:
  • 变量。   打印当前值velocity threshold of TAA (Temporal Anti-Aliasing), at which pixels are treated as fast moving ones.
  • 命令。   设置 velocity 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) and TAA velocity clamping (请参阅render_taa_frames_by_velocity).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_taa_fix_flicker
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the 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) is enabled.
    注意
    Enabling this option may increase performance costs.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_sraa
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_sraa_samples
说明/描 述:
  • 变量。   打印当前值number of depth geometry samples per pixel.
  • 命令。   设置 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.
参数:
0 - 2
1 - 4 (默认)
2 - 8
render_sraa_temporal
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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) is enabled. It is recommended to use this option by default.
参数:
0 -
1 - 开 (默认)
render_sraa_debug
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the SRAA debug mode is enabled. This mode shows the geometry edges smoothed by the SRAA.
参数:
0 - 关 (默认)
1 -
render_sraa_depth_threshold
说明/描 述:
  • 变量。   打印当前值depth threshold value used for edges detection that specifies the area for the SRAA processing.
  • 命令。   设置 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.
参数:
[0.0f; inf] - 可用范围
0.1f - 默认
render_filmic_shoulder_scale
说明/描 述:
  • 变量。   打印当前值Shoulder Strength tonemapping parameter value that is used to change bright values.
  • 命令。   设置 Shoulder Strength tonemapping parameter value that is used to change bright values.
参数:
[0.0f; 1.0f] - 可用范围
0.2f - 默认
render_filmic_linear_scale
说明/描 述:
  • 变量。   打印当前值Linear Strength tone mapping parameter value that is used to change gray values.
  • 命令。   设置 Linear Strength tone mapping parameter value that is used to change gray values. The Linear Scale controls the length of the tone mapping curve linear part.
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_filmic_linear_angle
说明/描 述:
  • 变量。   打印当前值Linear Angle tone mapping parameter value.
  • 命令。   设置 Linear Angle tone mapping parameter value. This parameter controls the slope of the linear part of the tone mapping curve.
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_filmic_toe_scale
说明/描 述:
  • 变量。   打印当前值Toe Scale tonemapping parameter value that is used to change dark values.
  • 命令。   设置 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).
参数:
[0.0f; 1.0f] - 可用范围
0.2f - 默认
render_filmic_toe_numerator
说明/描 述:
  • 变量。   打印当前值Toe Numerator tonemapping parameter value.
  • 命令。   设置 Toe Numerator tonemapping parameter value.
参数:
[0.0f; 1.0f] - 可用范围
0.01f - 默认
render_filmic_toe_denominator
说明/描 述:
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_filmic_white_level
说明/描 述:
  • 变量。   打印当前值Linear White Point tonemapping parameter value, which is mapped as pure white in the resulting image.
  • 命令。   设置 Linear White Point tonemapping parameter value, which is mapped as pure white in the resulting image.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_filmic_saturation_recovery
说明/描 述:
  • 变量。   打印当前值color saturation recovery value for the filmic tonemapper.
  • 命令。   设置 color 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:
    • 0.0f - standard filmic tonemapping, no saturation recovery is performed.
    • 1.0f - color saturation is recovered to the full extent.
    注意
    When the 1.0f value is set specular highlights appear too saturated, so the recommended value is 0.75f (default)
参数:
[0.0f; 1.0f] - 可用范围
0.75f - 默认
render_cross
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if cross flares are enabled.
参数:
0 - 关 (默认)
1 -
render_cross_color
说明/描 述:
  • 变量。   打印当前值color of the cross flares.
  • 命令。   设置 color of the cross flares. To use this option, rendering of cross flares (请参阅render_cross) should be enabled.
参数:
vec4_one - default value (white)
render_cross_scale
说明/描 述:
  • 变量。   打印当前值cross color scale — a multiplier for the color of cross flares.
  • 命令。   设置 color multiplier.cross color scale — a multiplier for the color of cross flares. Higher values produce more pronounced flares. To use this option, rendering of cross flares (请参阅render_cross) should be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_cross_shafts
说明/描 述:
  • 变量。   打印当前值number of shafts in a cross flare.
  • 命令。   设置 number of 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) should be enabled.
参数:
[2; 32] - 可用范围
4 - 默认
render_cross_length
说明/描 述:
  • 变量。   打印当前值length of a cross flare relative to the screen width.
  • 命令。   设置 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) should be enabled.
参数:
[0.0f; 2.0f] - 可用范围
0.2f - 默认
render_cross_angle
说明/描 述:
  • 变量。   打印当前值cross flares orientation angle.
  • 命令。   设置 cross flares orientation angle. To use this option, rendering of cross flares (请参阅render_cross) should be enabled.
参数:
[-inf; inf] - 可用范围
45.0f - 默认
render_cross_threshold
说明/描 述:
  • 变量。   打印当前值brightness threshold for areas to produce flare
  • 命令。   设置 brightness 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) should be enabled.
参数:
[0.0f; inf] - 可用范围
0.0f - 默认
render_distance_scale
说明/描 述:
  • 变量。   打印当前值global distance multiplier for all distance parameters, such as the world rendering distance, decal distance, field distance, light distance, object distance, reflection distance, LODs, and surface visibility distances.
  • 命令。   设置 global distance multiplier for all distance parameters, such as the world rendering distance, decal distance, field distance, light distance, object distance, reflection distance, 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.
    注意
    Increasing the value leads to decreasing the performance. The maximum recommended value is 4.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_distance_offset
说明/描 述:
  • 变量。   打印当前值global distance offset for all distance parameters: shadow distance, light distance, LOD distances, etc.
  • 命令。   设置 global distance offset for all distance parameters: shadow distance, light distance, LOD distances, etc.
参数:
[0.0f; inf] - 可用范围
0.0f - 默认
render_decal_distance
说明/描 述:
  • 变量。   打印当前值distance at which (and farther) decals will not be rendered.
  • 命令。   设置 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 value, the latter is used instead.
参数:
[0.0f; inf] - 可用范围
inf - 默认
render_field_distance
说明/描 述:
  • 变量。   打印当前值distance at which (and farther) field nodes will not be rendered.
  • 命令。   设置 distance at which (and farther) field 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 value, the latter is used instead.
参数:
[0.0f; inf] - 可用范围
inf - 默认
render_light_distance
说明/描 述:
  • 变量。   打印当前值distance at which (and farther) dynamic lights will not be rendered.
  • 命令。   设置 distance at which (and farther) dynamic 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 value, the latter is used instead.
参数:
[0.0f; inf] - 可用范围
inf - 默认
render_object_distance
说明/描 述:
  • 变量。   打印当前值distance at which (and farther) objects will not be rendered.
  • 命令。   设置 distance at which (and farther) objects will not be rendered.
    注意
    If this value is less than the scale multiplier for shadows (请参阅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.
参数:
[0.0f; inf] - 可用范围
inf - 默认
render_reflection_dynamic
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if dynamic reflections for materials are enabled.
参数:
0 -
1 - 开 (默认)
render_reflection_dynamic_roughness_offset
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 - 关 (默认)
1 -
render_reflection_lods
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if reduction of resolution of dynamic reflections when the camera moves away is enabled.
参数:
0 -
1 - 开 (默认)
render_reflection_distance
说明/描 述:
  • 变量。   打印当前值distance starting from which (and farther) reflections will not be rendered.
  • 命令。   设置 distance starting from which (and farther) reflections will not be rendered.
参数:
[0.0f; inf] - 可用范围
inf - 默认
render_wireframe_color
说明/描 述:
  • 变量。   打印当前值color of the wireframe.
  • 命令。   设置 color of the wireframe.
参数:
vec4_one - default value (white)
render_background_color
说明/描 述:
  • 变量。   打印当前值background color vector.
  • 命令。   设置 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.
参数:
vec4_one - default value (white)
render_fade_color
说明/描 述:
  • 变量。   打印当前值fade color for the scene on the screen.
  • 命令。   设置 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.
参数:
vec4_zero - default value (white)
render_lens
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if lens flares are enabled.
参数:
0 - 关 (默认)
1 -
render_lens_color
说明/描 述:
  • 变量。   打印当前值color of HDR lens flares.
  • 命令。   设置 color of HDR lens flares. To use this option, rendering of lens flares (请参阅render_lens) should be enabled.
参数:
vec4_one - default value (white)
render_lens_scale
说明/描 述:
  • 变量。   打印当前值multiplier for color (请参阅render_lens_color) of HDR lens flares.
  • 命令。   设置 multiplier for color (请参阅render_lens_color) of HDR lens flares. To use this option, rendering of lens flares (请参阅render_lens) should be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_lens_length
说明/描 述:
  • 变量。   打印当前值length of the radial lens flare indicating if the whole radial lens flare is rendered on the screen or only a part of it.
  • 命令。   设置 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) should be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_lens_radius
说明/描 述:
  • 变量。   打印当前值radius of the spherical lens flares on the screen.
  • 命令。   设置 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) should be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_lens_threshold
说明/描 述:
  • 变量。   打印当前值value of the brightness threshold for areas to produce lens flares.
  • 命令。   设置 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) should be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_lens_dispersion
说明/描 述:
  • 变量。   打印当前值color displacement for red, green, and blue channels of the lens flares.
  • 命令。   设置 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) should be enabled.
参数:
vec3_one - default value
render_motion_blur
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the motion blur effect is enabled.
参数:
0 -
1 - 开 (默认)
render_motion_blur_preset
说明/描 述:
  • 变量。   打印当前值Motion Blur preset. To customize the Motion Blur effect options at run time you should activate the Custom preset:
  • 命令。   设置 Motion Blur preset. To customize the Motion Blur effect options at run time you should activate the Custom preset:
参数:
0 - Low (默认)
1 - Medium
2 - High
3 - Ultra
4 - Custom
render_motion_blur_camera_velocity
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if camera velocity contributes to the 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) should be enabled.
    注意
    Disabled in VR mode by default.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_motion_blur_velocity_blur_samples
说明/描 述:
  • 变量。   打印当前值number of iterations performed to blur the border between moving and static objects.
  • 命令。   设置 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) should be enabled.
    注意
    Disabled in VR mode by default.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0; 512] - 可用范围
32 - 默认
render_motion_blur_velocity_blur_radius
说明/描 述:
  • 变量。   打印当前值radius of the motion blur effect for the boundary between moving and static objects.
  • 命令。   设置 radius of the motion blur effect for the boundary between moving and static objects.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_motion_blur_depth_threshold_near
说明/描 述:
  • 变量。   打印当前值value defining if the blur effect is applied to the foreground object.
  • 命令。   设置 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) should be enabled.
    注意
    Disabled in VR mode by default.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
0.2f - 默认
render_motion_blur_depth_threshold_far
说明/描 述:
  • 变量。   打印当前值value defining if the blur effect is applied to the background object.
  • 命令。   设置 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) should be enabled.
    注意
    Disabled in VR mode by default.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_motion_blur_noise_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the noise used in the motion blur.
  • 命令。   设置 intensity of the noise used in the motion blur. To use this option, rendering of the motion blur effect (请参阅render_motion_blur) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_motion_blur_num_steps
说明/描 述:
  • 变量。   打印当前值number of steps used in the motion blur.
  • 命令。   设置 number of steps used in the 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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[2; 64] - 可用范围
8 - 默认
render_motion_blur_velocity_scale
说明/描 述:
  • 变量。   打印当前值scale value of bodies' linear and angular velocities used for the motion blur.
  • 命令。   设置 scale value 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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_motion_blur_max_velocity
说明/描 述:
  • 变量。   打印当前值maximum possible amount of motion blur for moving physical objects.
  • 命令。   设置 maximum possible amount of 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 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.
    To use this option, rendering of the motion blur effect (请参阅render_motion_blur) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_transparent_blur
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if transparent blur is enabled for materials. This option makes it possible to render matte transparent materials like matte glass.
参数:
0 -
1 - 开 (默认)
render_refraction
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if refraction is enabled.
参数:
0 -
1 - 开 (默认)
render_refraction_warp_background_transparent_surfaces
说明/描 述:
  • 变量。   打印当前值value indicating if refraction affects background transparent surfaces (except for water and clouds).
  • 命令。   设置 value indicating if refraction affects background transparent surfaces (except for water and clouds). The following values are available:
    • 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.
    This method takes effect only when rendering of refractions (请参阅render_refraction) is enabled.
参数:
0 - Never (默认)
1 - Behind Farthest Refractive Surface
render_refraction_dispersion
说明/描 述:
  • 变量。   打印当前值refraction displacement for red, green, and blue channels (according to the refraction texture of refractive materials).
  • 命令。   设置 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) should be enabled.
参数:
vec3_one - default value
render_sharpen
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the sharpening post-processing effect is enabled.
参数:
0 - 关 (默认)
1 -
render_sharpen_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the sharpening effect.
  • 命令。   设置 intensity of the sharpening effect.intensity of the sharpening effect. To use this option, sharpening post-processing effect should be enabled (请参阅render_sharpen).
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_vr_emulation
说明/描 述:
  • 变量。   打印当前值value indicating the current VR emulation mode.
  • 命令。   设置 value indicating the current VR emulation mode.
参数:
0 - Disabled (默认)
1 - HTC Vive
2 - HTC Vive Pro
3 - Oculus Rift
render_ssr
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the SSR (Screen Space Reflections) effect is enabled.
参数:
0 - 关 (默认)
1 -
render_ssr_preset
说明/描 述:
  • 变量。   打印当前值SSR (Screen-Space Reflections) preset used at the moment. To customize the SSR effect options at run time you should activate the Custom preset:
  • 命令。   设置 SSR (Screen-Space Reflections) preset used at the moment. To customize the SSR effect options at run time you should activate the Custom preset:
参数:
0 - Low (默认)
1 - Medium
2 - High
3 - Ultra
4 - Extreme
5 - Custom
说明/描 述:
说明/描 述:
render_ssr_alpha_accumulation_mode
说明/描 述:
  • 变量。   打印当前值accumulation mode for Alpha values used when rendering screen-space reflections.
  • 命令。   设置 accumulation mode 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - Correct
1 - Boosted (默认)
render_ssr_increased_accuracy
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_ssr_resolution
说明/描 述:
  • 变量。   打印当前值resolution of SSR (Screen Space Reflections).
  • 命令。   设置 resolution of SSR (Screen Space Reflections).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (1)
render_ssr_resolution_depth
说明/描 述:
  • 变量。   打印当前值resolution of the depth buffer used for SSR (Screen Space Reflections) calculation.
  • 命令。   设置 resolution of the depth buffer used for SSR (Screen Space Reflections) calculation. It affects detailing of reflections of tiny objects.
    注意
    To gain performance, this option can be set to lower values while enabling increased accuracy (请参阅render_ssr_increased_accuracy).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (0)
render_ssr_resolution_color
说明/描 述:
  • 变量。   打印当前值resolution of the color buffer used for SSR (Screen Space Reflections) calculation.
  • 命令。   设置 resolution of the color buffer used for SSR (Screen Space Reflections) calculation. It significantly affects performance.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (0)
render_ssr_perspective_compensation
说明/描 述:
  • 变量。   打印当前值perspective compensation value for the SSR effect.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssr_num_rays
说明/描 述:
  • 变量。   打印当前值number of SSR rays per pixel that are used to calculate rough refrections.
  • 命令。   设置 number of SSR rays per pixel that are used to calculate rough refrections. Using more rays provides more precise SSR roughness calculation, however, it is more expensive.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 64] - 可用范围
4 - 默认
render_ssr_num_steps
说明/描 述:
  • 变量。   打印当前值number of SSR steps per ray that are used for trace calculation.
  • 命令。   设置 number of SSR 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 64] - 可用范围
16 - 默认
render_ssr_step_size
说明/描 述:
  • 变量。   打印当前值size of the trace step used for SSR calculation.
  • 命令。   设置 size of the trace step 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_ssr_non_linear_step_size
说明/描 述:
  • 变量。   打印当前值linear step size for the SSR effect.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssr_visibility_roughness_min
说明/描 述:
  • 变量。   打印当前值minimum roughness value, starting from which the SSR (Screen-Space Reflections) effect begins to fade out.
  • 命令。   设置 minimum roughness value, starting from which the SSR (Screen-Space Reflections) effect begins to fade out. It allows reducing noise of reflections on rough materials.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssr_visibility_roughness_max
说明/描 述:
  • 变量。   打印当前值maximum roughness value, starting from which the SSR (Screen-Space Reflections) effect is not rendered.
  • 命令。   设置 maximum roughness value, starting from which the SSR (Screen-Space Reflections) effect is not rendered. It allows reducing noise of reflections on rough materials.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssr_roughness_mip_offset
说明/描 述:
  • 变量。   打印当前值mip offset value for the SSR effect on rough surfaces.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 10.0f] - 可用范围
4.0f - 默认
render_ssr_threshold
说明/描 述:
  • 变量。   打印当前值threshold used for SSR (Screen-Space Reflections) calculation to limit imitation of reflections in areas where SSR cannot get information.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssr_threshold_occlusion
说明/描 述:
  • 变量。   打印当前值value that limits imitation of environment cubemap occlusion in areas where SSR (Screen-Space Reflections) cannot get information.
  • 命令。   设置 value that limits 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssr_normal_bias
说明/描 述:
  • 变量。   打印当前值bias value to which the ray starting position has been shifted along the normal vector.
  • 命令。   设置 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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssr_view_bias
说明/描 述:
  • 变量。   打印当前值bias value to which the ray starting position has been shifted along the view vector.
  • 命令。   设置 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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssr_tonemapping_gamma
说明/描 述:
  • 变量。   打印当前值tonemapping Gamma value for the SSR effect.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 10.0f] - 可用范围
2.0f - 默认
说明/描 述:
render_ssrtgi_preset
说明/描 述:
  • 变量。   打印当前值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:
  • 命令。   设置 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:
参数:
0 - Disabled (默认)
1 - Low
2 - Medium
3 - High
4 - Ultra
5 - Extreme
6 - Custom
render_ssrtgi_fast_tracing
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_ssrtgi_increased_accuracy
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
说明/描 述:
render_ssrtgi_noise_step
说明/描 述:
  • 变量。   打印当前值intensity of the step noise used for SSRTGI calculation.
  • 命令。   设置 intensity of the step noise used for SSRTGI calculation. This parameter is used to reduce the banding effect of tracing by using the noise: the higher is the value, the less pronounced is the banding effect. SSRTGI must be enabled (请参阅render_ssrtgi_preset).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_ssrtgi_num_rays
说明/描 述:
  • 变量。   打印当前值number of rays of SSRTGI per pixel that are used to calculate the final image.
  • 命令。   设置 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).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 1024] - 可用范围
8 - 默认
render_ssrtgi_num_steps
说明/描 述:
  • 变量。   打印当前值number of steps of SSRTGI per ray that are used for trace calculation.
  • 命令。   设置 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).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 256] - 可用范围
8 - 默认
render_ssrtgi_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the SSRTGI (screen space ray-traced global illumination) effect.
  • 命令。   设置 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).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (1)
render_ssrtgi_resolution_depth
说明/描 述:
  • 变量。   打印当前值resolution of the depth buffer used for SSRTGI (screen space ray-traced global illumination) calculation.
  • 命令。   设置 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). SSRTGI must be enabled (请参阅render_ssrtgi_preset).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (0)
render_ssrtgi_step_size
说明/描 述:
  • 变量。   打印当前值size of the trace step used for SSRTGI calculation.
  • 命令。   设置 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).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssrtgi_upscaling
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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).
参数:
0 -
1 - 开 (默认)
render_sssss
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭 value indicating if the SSSSS (Screen-Space Subsurface Scattering) effect is enabled. This effect is used to imitate human skin, wax, etc.
参数:
0 - 关 (默认)
1 -
render_sssss_preset
说明/描 述:
  • 变量。   打印当前值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:
  • 命令。   设置 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:
参数:
0 - Low (默认)
1 - Medium
2 - High
3 - Ultra
4 - Extreme
5 - Custom
render_sssss_diffuse
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_sssss_ambient
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_sssss_radius
说明/描 述:
  • 变量。   打印当前值subsurface scattering radius — distance in the screen space, within which colors will be sampled.
  • 命令。   设置 subsurface scattering 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_sssss_color
说明/描 述:
  • 变量。   打印当前值subsurface scattering 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.
  • 命令。   设置 subsurface scattering 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) should be enabled.
参数:
vec4(1.0f, 0.0f, 0.0f, 1.0f) - default value
render_sssss_max_threshold
说明/描 述:
  • 变量。   打印当前值threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's Translucent parameter equal to 1 (maximum translucency).
  • 命令。   设置 threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's Translucent parameter equal to 1 (maximum translucency). To use this option, the SSSSS effect (请参阅render_sssss) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
10.0f - 默认
render_sssss_min_threshold
说明/描 述:
  • 变量。   打印当前值threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's Translucent parameter equal to 0 (minimum translucency).
  • 命令。   设置 threshold of SSSSS (Screen-Space Subsurface Scattering) for the material's Translucent parameter equal to 0 (minimum translucency). To use this option, the SSSSS effect (请参阅render_sssss) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
4.0f - 默认
render_sssss_noise_ray
说明/描 述:
  • 变量。   打印当前值intensity of the ray noise used for SSSSS (Screen-Space Subsurface Scattering) calculation to reduce banding artifacts of tracing.
  • 命令。   设置 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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_sssss_noise_step
说明/描 述:
  • 变量。   打印当前值intensity of the step noise used for SSSSS (Screen-Space Subsurface Scattering) calculation to reduce banding artifacts of tracing.
  • 命令。   设置 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) should be enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_sssss_interleaved
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the interleaved rendering mode 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, which reduces ghosting and noise artifacts.

参数:
0 - 关 (默认)
1 -
render_sssss_interleaved_color_clamping
说明/描 述:
  • 变量。   打印当前值color clamping mode used to reduce ghosting effect.
  • 命令。   设置 color clamping mode 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - Disabled
1 - Low (默认)
2 - Medium
3 - High
4 - High + Velocity
render_sssss_interleaved_samples
说明/描 述:
  • 变量。   打印当前值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.
  • 命令。   设置 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
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 1 x 2 (默认)
1 - 2 x 2
render_sssss_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the SSSSS (Screen-Space Subsurface Scattering) effect.
  • 命令。   设置 resolution of the SSSSS (Screen-Space Subsurface Scattering) effect.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (1)
render_sssss_quality
说明/描 述:
  • 变量。   打印当前值quality of the SSSSS (Screen-Space Subsurface Scattering) effect.
  • 命令。   设置 quality of the SSSSS (Screen-Space Subsurface Scattering) effect.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_sssss_taa_fix_flicker
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value of TAA parameter for Screen-Space Subsurface Scattering that is similar to TAA Fix Flicker (请参阅render_taa_fix_flicker).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_sssss_taa_antialiasing_in_motion
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_sssss_taa_frames_by_color
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value of TAA parameter for Screen-Space Subsurface Scattering that is similar to TAA Frames By Color (请参阅render_taa_frames_by_color).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_sssss_taa_frames_by_velocity
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value of TAA parameter for Screen-Space Subsurface Scattering that is similar to TAA Frames By Velocity (请参阅render_taa_frames_by_velocity).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_sssss_taa_preserve_details
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
0.5f - 默认
render_sssss_taa_frame_count
说明/描 述:
参数:
[0.0f; inf] - 可用范围
30.0f - 默认
render_sssss_taa_frames_velocity_threshold
说明/描 述:
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_sssss_taa_max_frames_by_velocity
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
60.0f - 默认
render_sssss_taa_min_frames_by_velocity
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
4.0f - 默认
render_sssss_taa_pixel_offset
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_sssss_taa_catmull_resampling
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value of TAA parameter for Screen-Space Subsurface Scattering that is similar to TAA Catmull Resampling (请参阅render_taa_catmull_resampling).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_sssss_taa_samples
说明/描 述:
  • 变量。   打印当前值value of TAA parameter for Screen-Space Subsurface Scattering that is similar to TAA Samples (请参阅render_taa_samples).
  • 命令。   设置 value of TAA parameter for Screen-Space Subsurface Scattering that is similar to TAA Samples (请参阅render_taa_samples).
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 1 sample offset, no anti-aliasing
1 - 4 offsets (默认)
2 - 8 offsets
3 - 16 offsets
render_translucent_color
说明/描 述:
  • 变量。   打印当前值color used for translucent objects globally.
  • 命令。   设置 color used for translucent objects globally. When light shines on one side of the object, the other side is partially illuminated with this color.
参数:
vec4(1.0f, 1.0f, 1.0f, 1.0f) - default value (white)
render_ssbevel
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the Screen-Space Bevels (SSBevel effect) are enabled.
参数:
0 -
1 - 开 (默认)
render_ssbevel_vertex_normal
说明/描 述:
  • 变量。   打印当前值rendering mode of the screen-space bevels.
  • 命令。   设置 rendering mode of the screen-space bevels. The following modes are available:
    • 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.
    To use this option, rendering of SSBevel (请参阅render_ssbevel) should be enabled.
参数:
0 - Better Edges (默认)
1 - Better Normals
render_ssbevel_quality
说明/描 述:
  • 变量。   打印当前值quality mode for the screen-space bevels.
  • 命令。   设置 quality mode for the screen-space bevels.
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_ssbevel_radius
说明/描 述:
  • 变量。   打印当前值size of the Screen-Space Bevel effect.
  • 命令。   设置 size of the Screen-Space Bevel effect. To use this option, rendering of SSBevel (请参阅render_ssbevel) should be enabled.
参数:
[0.0f; inf] - 可用范围
0.01f - 默认
render_ssbevel_noise
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the noise is enabled for smoothing bevels. It is recommended to use the noise with 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) should be enabled.
参数:
0 -
1 - 开 (默认)
render_ssdirt
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the Screen-Space Dirt (SSDirt) effect is enabled.
参数:
0 - 关 (默认)
1 -
render_ssdirt_quality
说明/描 述:
  • 变量。   打印当前值quality for the SSDirt effect.
  • 命令。   设置 quality for the SSDirt effect. SSDirt (请参阅render_ssdirt) must be enabled. Quality implies the number of samples used for the Screen-Space Dirt effect:
    • Low — 4 samples
    • Medium — 8 samples
    • High — 16 samples
    • Ultra — 32 samples
    注意
    This parameter significantly affects performance, so choose it reasonably.
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (2)
render_ssdirt_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the SSDirt effect.
  • 命令。   设置 resolution of the SSDirt effect. SSDirt (请参阅render_ssdirt) must be enabled.
    注意
    This parameter significantly affects performance, so choose it reasonably.
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (1)
render_ssdirt_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the SSDirt effect.
  • 命令。   设置 intensity of the SSDirt effect.
    • By the minimum value of 0.0f, the effect is not visible.
    • Higher values make the effect more pronounced.
    SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssdirt_radius
说明/描 述:
  • 变量。   打印当前值size of the SSDirt effect.
  • 命令。   设置 size of the SSDirt effect. SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssdirt_threshold
说明/描 述:
  • 变量。   打印当前值threshold of the SSDirt effect.
  • 命令。   设置 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) must be enabled.
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_ssdirt_angle_bias
说明/描 述:
  • 变量。   打印当前值angle bias value to limit the SSDirt effect where information cannot be obtained.
  • 命令。   设置 angle bias value to limit the SSDirt effect where information cannot be obtained. This parameter can be used to remove visual artefacts at the edges of polygons. SSDirt (请参阅render_ssdirt) must be enabled.
    注意
    This parameter affects both, concave and convex areas.
参数:
[0.0f; 1.0f] - 可用范围
0.35f - 默认
render_ssdirt_perspective
说明/描 述:
  • 变量。   打印当前值perspective value, that determines the degree of impact of distance from the camera on the radius of the Screen-Space Dirt effect.
  • 命令。   设置 perspective value, that determines the degree of impact of distance from the camera on the radius of the Screen-Space Dirt effect.
    • 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).
    SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.02f - 默认
render_ssdirt_increase_accuracy
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if increased accuracy for the SSDirt 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) must be enabled.
参数:
0 - 关 (默认)
1 -
render_ssdirt_cavity_texture_size
说明/描 述:
  • 变量。   打印当前值scaling factor for the textures used for cavities.
  • 命令。   设置 scaling factor for the textures used for cavities. SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssdirt_cavity_color
说明/描 述:
  • 变量。   打印当前值color multiplier for the Albedo texture used for cavities (global dirt and dust color pattern).
  • 命令。   设置 color multiplier for the Albedo texture used for cavities (global dirt and dust color pattern). SSDirt (请参阅render_ssdirt) must be enabled.
参数:
vec4(0.26f, 0.24f, 0.21f, 1.0f) - default value
render_ssdirt_cavity_exponent
说明/描 述:
  • 变量。   打印当前值exponent value that determines the rate of gradual change of intensity along the radius for cavities.
  • 命令。   设置 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) must be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssdirt_cavity_metalness
说明/描 述:
  • 变量。   打印当前值metalness value for cavities.
  • 命令。   设置 metalness value for cavities. When set to 0 (by default), the SSDirt effect does not modify metalness buffer in cavities. SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.0f - 默认
render_ssdirt_cavity_metalness_visibility
说明/描 述:
  • 变量。   打印当前值metalness visibility value for cavities.
  • 命令。   设置 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) must be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.0f - 默认
render_ssdirt_convexity_texture_size
说明/描 述:
  • 变量。   打印当前值scaling factor for the textures used for convexities.
  • 命令。   设置 scaling factor for the textures used for convexities. SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssdirt_convexity_color
说明/描 述:
  • 变量。   打印当前值color multiplier for the Albedo texture used for convexities (global wear and scratch color pattern).
  • 命令。   设置 color multiplier for the Albedo texture used for convexities (global wear and scratch color pattern). SSDirt (请参阅render_ssdirt) must be enabled.
参数:
vec4(0.48f, 0.44f, 0.39f, 1.0f) - default value
render_ssdirt_convexity_exponent
说明/描 述:
  • 变量。   打印当前值exponent value that determines the rate of gradual change of intensity along the radius for convexities.
  • 命令。   设置 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) must be enabled.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssdirt_convexity_metalness
说明/描 述:
  • 变量。   打印当前值metalness value for convexities.
  • 命令。   设置 metalness value for convexities. When set to 0 (by default), the SSDirt effect does not modify metalness buffer in convex areas. SSDirt (请参阅render_ssdirt) must be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.0f - 默认
render_ssdirt_convexity_metalness_visibility
说明/描 述:
  • 变量。   打印当前值metalness visibility value for convexities.
  • 命令。   设置 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) must be enabled.
参数:
[0.0f; 1.0f] - 可用范围
0.0f - 默认
render_tonemapper
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if tone mapping is enabled.
参数:
0 -
1 - 开 (默认)
render_tonemapper_mode
说明/描 述:
参数:
0 - Filmic
1 - ACES (默认)
2 - ACES with Reinhard
3 - Reinhard
4 - Reinhard Luma-Based
render_reinhard_contribution
说明/描 述:
  • 变量。   打印当前值Reinhard tonemapping operator contribution.
  • 命令。   设置 Reinhard tonemapping 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.

参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_reinhard_luma_based_contribution
说明/描 述:
  • 变量。   打印当前值Reinhard Luma-Based tonemapping operator contribution.
  • 命令。   设置 Reinhard Luma-Based tonemapping 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.
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_aces_with_reinhard_mix
说明/描 述:
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_aces_white_clip
说明/描 述:
  • 变量。   打印当前值white clip parameter for the ACES operator. Controls the cut-off point for white.
  • 命令。   设置 white clip parameter for the ACES operator. Controls the cut-off point for white.
参数:
[0.0f; 10.0f] - 可用范围
2.51f - 默认
render_aces_toe
说明/描 述:
  • 变量。   打印当前值toe parameter for the ACES operator.
  • 命令。   设置 toe parameter for the ACES operator. Controls the dark color. Higher values result in darker colors.
参数:
[0.0f; 10.0f] - 可用范围
0.03f - 默认
render_aces_shoulder_angle
说明/描 述:
  • 变量。   打印当前值shoulder angle parameter for the ACES operator.
  • 命令。   设置 shoulder angle parameter for the ACES operator. Controls how much overshoot should be added to the curve's shoulder.
参数:
[0.0f; 10.0f] - 可用范围
2.43f - 默认
render_aces_shoulder_strength
说明/描 述:
  • 变量。   打印当前值shoulder strength parameter for the ACES operator.
  • 命令。   设置 shoulder strength parameter for the ACES operator. Controls the strength of the transition between the curve's midsection and the curve's shoulder.
参数:
[0.0f; 10.0f] - 可用范围
0.59f - 默认
render_aces_shoulder_length
说明/描 述:
  • 变量。   打印当前值shoulder length parameter for the ACES operator.
  • 命令。   设置 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.
参数:
[0.0f; 1.0f] - 可用范围
0.59f - 默认
render_aces_with_reinhard_white_clip
说明/描 述:
  • 变量。   打印当前值white clip parameter for the ACES with Reinhard operator.
  • 命令。   设置 white clip parameter for the ACES with Reinhard operator. Controls the cut-off point for white.ACES with Reinhard operator's white clip.
参数:
[0.0f; 10.0f] - 可用范围
2.51f - 默认
render_aces_with_reinhard_toe
说明/描 述:
  • 变量。   打印当前值toe parameter for the ACES with Reinhard operator.
  • 命令。   设置 toe parameter for the ACES with Reinhard operator. Controls the dark color. Higher values result in darker colors.
参数:
[0.0f; 10.0f] - 可用范围
0.03f - 默认
render_aces_with_reinhard_shoulder_angle
说明/描 述:
  • 变量。   打印当前值shoulder angle parameter for the ACES with Reinhard operator.
  • 命令。   设置 shoulder angle parameter for the ACES with Reinhard operator. Controls how much overshoot should be added to the curve's shoulder.
参数:
[0.0f; 10.0f] - 可用范围
2.43f - 默认
render_aces_with_reinhard_shoulder_strength
说明/描 述:
  • 变量。   打印当前值shoulder strength parameter for the ACES with Reinhard operator.
  • 命令。   设置 shoulder strength parameter for the ACES with Reinhard operator. Controls the strength of the transition between the curve's midsection and the curve's shoulder.
参数:
[0.0f; 10.0f] - 可用范围
0.59f - 默认
render_aces_with_reinhard_shoulder_length
说明/描 述:
  • 变量。   打印当前值shoulder length parameter for the ACES with Reinhard operator.
  • 命令。   设置 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.
参数:
[0.0f; 1.0f] - 可用范围
0.14f - 默认

Lighting and ShadingLighting and Shading#

Operations on lighting and shading.

render_environment
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of environment of the scene is enabled.
参数:
0 -
1 - 开 (默认)
说明/描 述:
render_environment_cubemap_blend
说明/描 述:
  • 变量。   打印当前值blending mode for the environment cubemap.
  • 命令。   设置 blending mode for the environment cubemap.
参数:
0 - alpha blend (默认)
1 - additive blend
2 - multiply
3 - overlay
render_environment_hemisphere
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 - 关 (默认)
1 -
render_environment_haze
说明/描 述:
  • 变量。   打印当前值mode for the haze effect.
  • 命令。   设置 mode for the haze effect.
    • If Disabled, no haze is applied.
    • The Solid mode uses the solid color from the Color parameter.
    • The Scattering mode uses the color from the sky LUTs is blended with the Color parameter. This value is recommended for better realism: objects will smoothly fade into the distance.
参数:
0 - haze disabled
1 - haze colored the specific color
2 - haze colored in accordance with the sky LUT (默认)
render_environment_haze_gradient
说明/描 述:
  • 变量。   打印当前值environment haze gradient mode.
  • 命令。   设置 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
参数:
0 - Short Distance Range (默认)
1 - Long Distance Range
2 - Physically Based
render_environment_haze_screen_space_global_illumination
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
    注意
    Available for Physically Based haze gradient mode only.
参数:
0 -
1 - 开 (默认)
render_environment_haze_temporal_filter
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if temporal filtering for the Screen-Space Haze Global Illumination effect is enabled.
参数:
0 -
1 - 开 (默认)
render_environment_haze_colorization_threshold
说明/描 述:
  • 变量。   打印当前值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.
  • 命令。   设置 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.
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_environment_haze_colorization_intensity
说明/描 述:
  • 变量。   打印当前值colorization intensity value that defines haze color in "information lost" areas on the screen.
  • 命令。   设置 colorization intensity value that defines haze color in "information lost" areas on the screen.
    • 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.

    This parameter is ignored when Colorization Threshold is set to 1, as there will be no "information lost" areas not covered by SSHGI.

参数:
[0.0f; 1.0f] - 可用范围
0.95f - 默认
render_lightmap_color
说明/描 述:
  • 变量。   打印当前值color multiplier for lightmaps.
  • 命令。   设置 color multiplier for lightmaps.
    注意
    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 for additional information.
参数:
vec4_one - default value (white)
render_lights_max_per_batch
说明/描 述:
  • 变量。   打印当前值maximum number of lights rendered by a tile (请参阅render_lights_tile_grid_size) per batch call.
  • 命令。   设置 maximum number of lights rendered by a tile (请参阅render_lights_tile_grid_size) per batch call.

    With lights batching optimization, omni lights divided into tiles are rendered in batches: each tile renders the specified number of lights per batch. It allows decreasing the number of DIP calls and increasing performance. The optimization works only for omni lights with point shape and without shadows.

    0 disables batching optimization.

参数:
[32; 1024] - 可用范围
1024 - 默认
render_lights_tile_grid_size
说明/描 述:
  • 变量。   打印当前值number of grid tiles per axis for tiled rendering optimization.
  • 命令。   设置 number of grid tiles per axis for tiled rendering optimization. During this optimization, the screen space is divided into tiles that render lights in batches (请参阅render_lights_max_per_batch). The optimization works only for omni lights with point shape and without shadows.
参数:
[1; 32] - 可用范围
8 - 默认
render_lights_forward_per_object_world
说明/描 述:
  • 变量。   打印当前值maximum number of World lights per object (available only for materials rendered in the forward rendering pass).
  • 命令。   设置 maximum number of World lights per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 World lights per object.
参数:
[0; 128] - 可用范围
4 - 默认
render_lights_forward_per_object_omni
说明/描 述:
  • 变量。   打印当前值maximum number of Omni lights per object (available only for materials rendered in the forward rendering pass).
  • 命令。   设置 maximum number of Omni lights per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Omni lights per object.
参数:
[0; 128] - 可用范围
4 - 默认
render_lights_forward_per_object_proj
说明/描 述:
  • 变量。   打印当前值maximum number of Projected lights per object (available only for materials rendered in the forward rendering pass).
  • 命令。   设置 maximum number of Projected lights per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Projected lights per object.
参数:
[0; 128] - 可用范围
4 - 默认
render_lights_forward_per_object_env
说明/描 述:
  • 变量。   打印当前值maximum number of Environment Probes per object (available only for materials rendered in the forward rendering pass).
  • 命令。   设置 maximum number of Environment Probes per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Voxel Probes per object.
参数:
[0; 128] - 可用范围
4 - 默认
render_lights_forward_per_object_planar
说明/描 述:
  • 变量。   打印当前值maximum number of Planar Reflection Probes per object (available only for materials rendered in the forward rendering pass).
  • 命令。   设置 maximum number of Planar Reflection Probes per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Planar Reflection Probes per object.
参数:
[0; 128] - 可用范围
4 - 默认
render_lights_forward_per_object_voxel
说明/描 述:
  • 变量。   打印当前值maximum number of Voxel Probes per object (available only for materials rendered in the forward rendering pass).
  • 命令。   设置 maximum number of Voxel Probes per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Voxel Probes per object.
参数:
[0; 128] - 可用范围
4 - 默认
render_lights_lens_flares
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of per-light lens flares is enabled.
参数:
0 -
1 - 开 (默认)
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_ssao
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the SSAO (Screen Space Ambient Occlusion) effect is enabled.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_ssao_cavity
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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).
    注意
    When checking the parameter value via API, you'll get the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_ssao_cavity_intensity
说明/描 述:
  • 变量。   打印当前值intensity of sharpening of contours for the cavity option (请参阅render_ssao_cavity).
  • 命令。   设置 intensity of sharpening of contours for the cavity option (请参阅render_ssao_cavity).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_ssao_cavity_radius
说明/描 述:
  • 变量。   打印当前值size of junction contours area for the cavity option for the SSAO (Screen Space Ambient Occlusion) effect (请参阅render_ssao_cavity).
  • 命令。   设置 size of junction contours area for the cavity option for the SSAO (Screen Space Ambient Occlusion) effect (请参阅render_ssao_cavity).
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
说明/描 述:
render_ssao_threshold
说明/描 述:
  • 变量。   打印当前值threshold value for the SSAO (Screen Space Ambient Occlusion) effect.
  • 命令。   设置 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.
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_ssao_intensity
说明/描 述:
  • 变量。   打印当前值intensity of the SSAO (Screen Space Ambient Occlusion) for the scene.
  • 命令。   设置 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.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
说明/描 述:
render_ssao_intensity_reflection
说明/描 述:
  • 变量。   打印当前值intensity of SSAO (Screen Space Ambient Occlusion) on reflections.
  • 命令。   设置 intensity of SSAO (Screen Space Ambient Occlusion) on reflections.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
说明/描 述:
render_gbuffer_lightmap
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if lightmap data is stored in the gbuffer.
参数:
0 -
1 - 开 (默认)

ShadowsShadows#

Operations on shadows.

render_shadows
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether shadows are rendered.
参数:
0 -
1 - 开 (默认)
render_shadows_alpha_test
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if alpha test is enabled for shadows.
参数:
0 -
1 - 开 (默认)
render_shadows_screen_space
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 -
1 - 开 (默认)
render_shadows_translucent_depth
说明/描 述:
  • 变量。   打印当前值global translucence depth value defining how deep the light goes through translucent objects shifting the shadow.
  • 命令。   设置 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.
参数:
[0.0f; inf] - 可用范围
0.1f - 默认
render_shadow_distance
说明/描 述:
  • 变量。   打印当前值distance from the camera, beyond which shadows will not be rendered.
  • 命令。   设置 distance from the camera, beyond which shadows will not be rendered.
    注意
    If this value is greater than the visibility distance for objects 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.
参数:
[0.0f; inf] - 可用范围
100.0f - 默认
render_shadow_distance_scale
说明/描 述:
  • 变量。   打印当前值global scale multiplier for shadow distances.
  • 命令。   设置 global scale multiplier for shadow distances. This option enables you to easily increase or decrease shadows rendering performance by changing the scale.
    注意
    If this value is greater than the scale multiplier for objects (请参阅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.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_screen_space_shadow_shafts_mode
说明/描 述:
  • 变量。   打印当前值rendering mode for volumetric screen-space shadow shafts.
  • 命令。   设置 rendering mode for volumetric screen-space shadow shafts. 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.
    注意
    • 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.
参数:
0 - Disabled
1 - Sun shadow shafts (默认)
2 - Moon shadow shafts
3 - Sun and Moon shadow shafts
render_screen_space_shadow_shafts_length
说明/描 述:
参数:
[0.0f; 100.0f] - 可用范围
3.0f - 默认
render_screen_space_shadow_shafts_quality
说明/描 述:
  • 变量。   打印当前值quality of screen-space shadow shafts.
  • 命令。   设置 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.
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_screen_space_shadow_shafts_resolution
说明/描 述:
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (1)
render_show_cascades配置文件: *.user
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables displaying of Parallel Split Shadow Map - world shadow cascades.
参数:
0 - 关 (默认)
1 -
render_show_world_shadow_casters
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether the visualizer is displayed for surfaces that are configured to cast shadows from the current World Light.
参数:
0 - 关 (默认)
1 -
render_shadows_filter_mode
说明/描 述:
  • 变量。   打印当前值global filtering mode to be used for shadows from all light sources by default.
  • 命令。   设置 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.
    注意
    You can set filtering mode or disable filtering for each light source individually.
参数:
0 - Disabled
1 - Low
2 - Medium (默认)
3 - High
4 - Ultra
render_shadows_filter_noise
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if noise for shadow filtering is enabled. This noise is used for smoothing.
参数:
0 -
1 - 开 (默认)
render_shadows_penumbra_mode
说明/描 述:
  • 变量。   打印当前值global quality mode to be used for rendering penumbra from all light sources by default.
  • 命令。   设置 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).
    注意
    You can set penumbra quality mode or disable penumbra rendering for each light source individually. But these per-light quality settings are ignored when global quality is set to Disabled.
参数:
0 - Disabled
1 - Low (默认)
2 - Medium
3 - High
4 - Ultra
render_shadows_penumbra_noise
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if noise for penumbra rendering is enabled. This noise is used for smoothing.
参数:
0 -
1 - 开 (默认)
render_shadows_world_lerp_cascades
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if linear interpolation of shadow cascades is enabled, making transitions between cascades smoother. This option significantly affects performance, as two shadow maps are rendered in transition areas.
参数:
0 -
1 - 开 (默认)
render_shadows_world_cascades_culling_clusters
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 - 关 (默认)
1 -

GeodeticsGeodetics#

警告
本章介绍的功能在 Community SDK 版本中不可用。
您应该升级到 Engineering / Sim SDK版本才能使用它。

Operations on geodetics.

render_show_geodetic_pivot配置文件: *.
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating whether geodetic pivots are displayed.
参数:
0 - 关 (默认)
1 -

Clouds RenderingClouds Rendering#

render_clouds_quality_preset
说明/描 述:
  • 变量。   打印当前值index of the clouds quality preset used at the moment.
  • 命令。   设置 index of the clouds quality preset used at the moment.
参数:
0 - Low (默认)
1 - Medium
2 - High + Interleaved
3 - High
4 - Ultra + Interleaved
5 - Ultra
6 - Extreme + Interleaved
7 - Extreme
8 - Custom
render_clouds_accurate_layers_sorting
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if correct sorting of intersecting cloud layers is enabled.
    注意
    Enabling this feature may reduce raymarching quality as samples shall be distributed among all layers.
参数:
0 - 关 (默认)
1 -
render_clouds_depth_based_reconstruction
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
    注意
    Works only with the clouds downsampling rendering mode (请参阅render_clouds_downsampling_rendering) set to half and/or the clouds interleaved rendering mode (请参阅render_clouds_interleaved_rendering) set to 2x2.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - 关 (默认)
1 -
render_clouds_depth_based_reconstruction_threshold
说明/描 述:
  • 变量。   打印当前值depth threshold value for clouds depth-based reconstruction mode (请参阅render_clouds_depth_based_reconstruction).
  • 命令。   设置 depth threshold value for clouds depth-based reconstruction mode (请参阅render_clouds_depth_based_reconstruction). This value defines the depth difference starting from which pixels are considered to be related to different surfaces.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; inf] - 可用范围
100.0f - 默认
render_clouds_distortion_texture
说明/描 述:
  • 变量。   打印当前值value indicating which texture type is used for clouds distortion at the moment.
  • 命令。   设置 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.
参数:
0 - 2D texture (默认)
1 - 3D texture
render_clouds_downsampling_rendering
说明/描 述:
  • 变量。   打印当前值downsampling rendering mode for clouds.
  • 命令。   设置 downsampling rendering mode for clouds. This parameter determines clouds resolution based on current screen resolution.
    注意
    This parameter has a significant impact on performance.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - quarter resolution
  • 1 - half resolution
  • 2 - full resolution
默认值为 (1)
render_clouds_dynamic_coverage_area
说明/描 述:
  • 变量。   打印当前值dynamic coverage area for clouds, in units.
  • 命令。   设置 dynamic coverage area for clouds, in units. This parameter determines visibility distance for coverage of FieldWeather objects.
    注意
    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).
参数:
[10.0f; 400000.0f] - 可用范围
10000.0f - 默认
render_clouds_dynamic_coverage_resolution
说明/描 述:
  • 变量。   打印当前值the value defining the size of the square dynamic coverage resolution texture for clouds, in pixels.
  • 命令。   设置 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. Higher values make it possible to preserve texture details at high distances.
    注意
    Increased resolution significantly affects performance.
参数:
[16; 8192] - 可用范围
256 - 默认
render_clouds_far_clipping
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if far-plane clipping 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.

参数:
0 -
1 - 开 (默认)
render_clouds_ground_shadows
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of shadows from the clouds on the ground is enabled.
参数:
0 -
1 - 开 (默认)
render_clouds_3d_texture_horizontal_resolution
说明/描 述:
  • 变量。   打印当前值horizontal resolution for the 3D texture to be used for clouds rendering.
  • 命令。   设置 horizontal resolution for the 3D texture to be used for clouds rendering.
    注意
    Setting too high resolution may significantly affect performance, so adjust it wisely.
参数:
0 - 64
1 - 128
2 - 256 (默认)
3 - 512
4 - 1024
5 - 2048
render_clouds_3d_texture_vertical_resolution
说明/描 述:
  • 变量。   打印当前值vertical resolution for the 3D texture to be used for clouds rendering.
  • 命令。   设置 vertical resolution for the 3D texture to be used for clouds rendering.
    注意
    Setting too high resolution may significantly affect performance, so adjust it wisely.
参数:
0 - 32
1 - 64
2 - 128
3 - 256 (默认)
4 - 512
render_clouds_interleaved_rendering
说明/描 述:
  • 变量。   打印当前值interleaved rendering mode for clouds.
  • 命令。   设置 interleaved rendering mode 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - Disabled (默认)
1 - 2×2
2 - 4×4
3 - 8×8
render_clouds_interleaved_rendering_temporal
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if temporal accumulation of noises for interleaved sampling for clouds is enabled.
    注意
    Works only when the clouds interleaved rendering mode (请参阅render_clouds_interleaved_rendering) is set to 2x2.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 -
1 - 开 (默认)
render_clouds_lighting_cone_radius
说明/描 述:
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_clouds_lighting_quality
说明/描 述:
  • 变量。   打印当前值lighting quality for clouds.
  • 命令。   设置 lighting quality for clouds. This parameter determines the number of samples used to calculate lighting for clouds. 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
    注意
    This parameter has a significant impact on performance. Therefore, it is recommended to use low settings, when possible.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_clouds_lighting_samples_distribution
说明/描 述:
  • 变量。   打印当前值value that controls distribution of samples for clouds lighting.
  • 命令。   设置 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) is high.
参数:
[0.001f; 5.0f] - 可用范围
1.0f - 默认
render_clouds_lighting_tracelength
说明/描 述:
参数:
[1.0f; 2048.0f] - 可用范围
230.0f - 默认
render_clouds_noise_step
说明/描 述:
  • 变量。   打印当前值value of the noise step parameter for clouds.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_clouds_noise_step_skip
说明/描 述:
  • 变量。   打印当前值value of the noise step skip parameter for clouds.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_clouds_noise_iterations
说明/描 述:
  • 变量。   打印当前值value of the noise iterations parameter for clouds.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.1f - 默认
render_clouds_noise_lighting
说明/描 述:
  • 变量。   打印当前值value of the noise lighting parameter for the clouds.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_clouds_rounded
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if cloud layers are to be curved to make them look more natural imitating planet's curvature.
参数:
0 -
1 - 开 (默认)
render_clouds_rounded_planet_radius
说明/描 述:
  • 变量。   打印当前值radius of the planet to be used for clouds curving.
  • 命令。   设置 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.
参数:
[100.0f; inf] - 可用范围
200000.0f - 默认
render_clouds_samples_count
说明/描 述:
  • 变量。   打印当前值number of samples used for clouds rendering.
  • 命令。   设置 number of samples 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
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (2)
render_clouds_sampling_quality
说明/描 述:
  • 变量。   打印当前值sampling quality for clouds.
  • 命令。   设置 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:
    • 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)
    注意
    Visual difference between low and ultra quality is not significant. Therefore, it is recommended to use low settings, when possible, to gain performance.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_clouds_soft_intersection
说明/描 述:
参数:
[0.0f; 100000.0f] - 可用范围
100.0f - 默认
render_clouds_step_accuracy
说明/描 述:
  • 变量。   打印当前值accuracy of ray marching steps.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_clouds_transparent_order
说明/描 述:
  • 变量。   打印当前值rendering order for clouds relative to transparent objects (except water).
  • 命令。   设置 rendering order for clouds relative to transparent objects (except water).
    • Render Before Transparent — render clouds before all transparent objects (except water).
    • Render After Transparent — render clouds after all transparent objects (except water).
    • Sort Transparent — enable rough sorting for transparent objects relative to clouds (below the lowest cloud layer base -> inside the clouds -> above the highest cloud layer top).
参数:
0 - Render Before Transparent (默认)
1 - Render After Transparent
2 - Sort Transparent

Terrain RenderingTerrain Rendering#

The commands described below are intended for configuring Landscape Terrain object (the ObjectLandscapeTerrain class).

警告
Changing some of the parameters below triggers reloading of the Landscape Terrain graphic data, so it's not recommended to do it at run time.
render_landscape_cache_cpu_size
说明/描 述:
  • 变量。   打印当前值CPU cache size to be used for landscape terrain rendering, in percentage of the total memory.
  • 命令。   设置 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.
参数:
[1; 100] - 可用范围
10 - 默认
render_landscape_cache_gpu_size
说明/描 述:
  • 变量。   打印当前值GPU cache size to be used for landscape terrain rendering, in percentage of the total GPU memory.
  • 命令。   设置 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.
    注意
    High-resolution maps require larger cache capacity.
参数:
[1; 100] - 可用范围
4 - 默认
render_landscape_cache_gpu_life_time
说明/描 述:
  • 变量。   打印当前值lifetime of GPU cache used for Landscape Terrain rendering, in frames.
  • 命令。   设置 lifetime of GPU cache used for Landscape Terrain rendering, in frames.
参数:
[1; 60] - 可用范围
4 - 默认
render_landscape_operations_per_frame
说明/描 述:
  • 变量。   打印当前值maximum number of Landscape texture draw operations (asyncTextureDraw) that can be performed per frame.
  • 命令。   设置 maximum number of Landscape texture draw operations (asyncTextureDraw) that can be performed per frame.
参数:
[1; 1000] - 可用范围
10 - 默认
render_landscape_terrain_culling_frustum_aggressive
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if frustum culling optimization is enabled for the Landscape Terrain. 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).
参数:
0 -
1 - 开 (默认)
render_landscape_terrain_culling_by_depth
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭 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.
参数:
0 -
1 - 开 (默认)
render_landscape_terrain_culling_depth_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the buffer used for culling by depth.
  • 命令。   设置 resolution of the buffer used for culling by depth.
参数:
[4; 2048] - 可用范围
64 - 默认
render_landscape_terrain_culling_padding_triangles
说明/描 述:
  • 变量。   打印当前值padding between LODs of tessellated polygons.
  • 命令。   设置 padding between LODs of tessellated polygons.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_landscape_terrain_culling_padding_patch_gpu
说明/描 述:
  • 变量。   打印当前值padding between LODs of patches culled on GPU.
  • 命令。   设置 padding between LODs of patches culled on GPU.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_landscape_terrain_culling_padding_patch_cpu
说明/描 述:
  • 变量。   打印当前值padding between LODs of patches culled on CPU.
  • 命令。   设置 padding between LODs of patches culled on CPU.
参数:
[0.0f; inf] - 可用范围
1.0f - 默认
render_landscape_terrain_culling_patch_batching
说明/描 述:
  • 变量。   打印当前值number of culling patches of Landscape Terrain processed in a batch.
  • 命令。   设置 number of culling patches of Landscape Terrain processed in a batch. The higher this value, the more patches will be checked for visibility on CPU at once.
参数:
[1; 64] - 可用范围
16 - 默认
render_landscape_terrain_culling_patch_resolution_gpu
说明/描 述:
  • 变量。   打印当前值number of subdivisions for patches of Landscape Terrain culled on the GPU side that are to be tessellated.
  • 命令。   设置 number of subdivisions for patches of Landscape Terrain 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.
参数:
[4; 64] - 可用范围
32 - 默认
render_landscape_terrain_culling_patch_resolution_cpu
说明/描 述:
  • 变量。   打印当前值number of subdivisions for patches of Landscape Terrain culled on the CPU side that are to be passed to GPU.
  • 命令。   设置 number of subdivisions for patches of Landscape Terrain 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.
参数:
[2; 64] - 可用范围
2 - 默认
render_landscape_terrain_culling_oblique_frustum
说明/描 述:
  • 变量。   打印当前值multiplier for culling of tessellation patches of the Landscape Terrain beyond the oblique frustum plane.
  • 命令。   设置 multiplier for culling of tessellation patches of the Landscape Terrain beyond the oblique frustum plane. Higher values result in more patches culled.
参数:
[0.0f; 1.0f] - 可用范围
0.9f - 默认
render_landscape_terrain_culling_map
说明/描 述:
参数:
[0.0f; 1.0f] - 可用范围
0.3f - 默认
render_landscape_terrain_detail_compression
说明/描 述:
  • 变量。   打印当前值mode of detail textures compression.
  • 命令。   设置 mode of detail textures compression. Compressed detail textures take less video memory.
参数:
0 - Disabled
1 - Fast Compression (默认)
2 - High Quality
render_landscape_terrain_detail_resolution_additional_mask
说明/描 述:
参数:
0 - 64×64
1 - 128×128
2 - 256×256
3 - 512×512
4 - 1024×1024 (默认)
5 - 2048×2048
6 - 4096×4096
7 - 8192×8192
8 - 16384×16384
render_landscape_terrain_detail_resolution_albedo
说明/描 述:
参数:
0 - 64×64
1 - 128×128
2 - 256×256
3 - 512×512
4 - 1024×1024 (默认)
5 - 2048×2048
6 - 4096×4096
7 - 8192×8192
8 - 16384×16384
render_landscape_terrain_detail_resolution_height
说明/描 述:
参数:
0 - 64×64
1 - 128×128
2 - 256×256
3 - 512×512
4 - 1024×1024 (默认)
5 - 2048×2048
6 - 4096×4096
7 - 8192×8192
8 - 16384×16384
render_landscape_terrain_mask_dithering
说明/描 述:
参数:
[0.0f; 1.0f] - 可用范围
1.0f - 默认
render_landscape_terrain_geometry_detail_max_height
说明/描 述:
  • 变量。   打印当前值maximum height for detail displacement clamping.
  • 命令。   设置 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.
参数:
[0.0f; 10.0f] - 可用范围
0.5f - 默认
render_landscape_terrain_geometry_holes
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if decal-based holes for the Landscape Terrain are enabled.
参数:
0 -
1 - 开 (默认)
render_landscape_terrain_geometry_polygon_size
说明/描 述:
  • 变量。   打印当前值size of Landscape Terrain polygons defining the maximum allowed density of Landscape Terrain geometry.
  • 命令。   设置 size of Landscape Terrain polygons defining the maximum allowed density of Landscape Terrain geometry.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1000.0f] - 可用范围
0.01f - 默认
render_landscape_terrain_geometry_progression
说明/描 述:
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 50.0f] - 可用范围
1.5f - 默认
render_landscape_terrain_geometry_subpixel_reduction
说明/描 述:
  • 变量。   打印当前值minimum ratio between the polygon size (in screen space) to the size of an area in the viewport for skipping polygons rendering (the ones having a lower ratio will be removed).
  • 命令。   设置 minimum ratio between the polygon size (in screen space) to the size of an area in the viewport for skipping polygons rendering (the ones having a lower ratio will be removed).
    注意
    Setting too high values may cause small but noticeable visual artifacts when the camera moves.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 50.0f] - 可用范围
6.0f - 默认
render_landscape_terrain_geometry_preset
说明/描 述:
  • 变量。   打印当前值index of the Landscape Terrain geometry preset used at the moment.
  • 命令。   设置 index of the Landscape Terrain geometry preset used at the moment.
    注意
    Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API 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).
参数:
0 - Low (默认)
1 - Medium
2 - High
3 - Ultra
4 - Extreme
5 - Custom
render_landscape_terrain_streaming_preset
说明/描 述:
  • 变量。   打印当前值index of the Landscape Terrain streaming preset used at the moment.
  • 命令。   设置 index of the Landscape Terrain streaming preset used at the moment.
    注意
    Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API 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).
参数:
0 - Low (默认)
1 - Medium
2 - High
3 - Ultra
4 - Extreme
5 - Custom
render_landscape_terrain_streaming_threads
说明/描 述:
  • 变量。   打印当前值number of threads used for streaming.
  • 命令。   设置 number of threads used for streaming.
参数:
[0; 32] - 可用范围
1 - 默认
render_landscape_terrain_streaming_per_lods
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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.
参数:
0 -
1 - 开 (默认)
render_landscape_terrain_texel_size
说明/描 述:
  • 变量。   打印当前值texel size of the Landscape Terrain render textures representing the maximum level of detail for the albedo, normal, and height components of the Landscape Terrain.
  • 命令。   设置 texel size of the Landscape Terrain render textures representing the maximum level of detail for the albedo, normal, and height components of the Landscape Terrain.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0001f; 1.0f] - 可用范围
0.001f - 默认
render_landscape_terrain_visible_distance
说明/描 述:
参数:
[0.0f; inf] - 可用范围
30000.0f - 默认
render_landscape_terrain_vt_detail_level_by_angle
说明/描 述:
  • 变量。   打印当前值value indicating detail level reduction depending on the inclination of the the Landscape Terrain polygons relative to viewing direction.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.95f - 默认
render_landscape_terrain_vt_filtering
说明/描 述:
  • 变量。   打印当前值filtering mode for the Landscape Terrain textures.
  • 命令。   设置 filtering mode for the Landscape Terrain 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
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
0 - Low
1 - Medium (默认)
2 - High
render_landscape_terrain_vt_hash_size
说明/描 述:
  • 变量。   打印当前值upper limit for the hash function used to determine tiles of Landscape Terrain.
  • 命令。   设置 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.
参数:
[1000; 5000000] - 可用范围
1000000 - 默认
render_landscape_terrain_vt_hash_number_mistakes
说明/描 述:
  • 变量。   打印当前值number of mistakes of the hash function used in Landscape Terrain data streaming.
  • 命令。   设置 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.
参数:
[1; 32] - 可用范围
2 - 默认
render_landscape_terrain_vt_memory_size
说明/描 述:
  • 变量。   打印当前值value defining memory consumption for the Landscape Terrain textures.
  • 命令。   设置 value defining memory consumption for the Landscape Terrain textures. The value is interpreted as follows:
    • 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)
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.4f - 默认
render_landscape_terrain_vt_target_resolution
说明/描 述:
  • 变量。   打印当前值target resolution (width x height) for the Landscape Terrain, in pixels.
  • 命令。   设置 target resolution (width x height) for the Landscape Terrain, in pixels.
参数:
1344 х 756 - (default)
render_landscape_terrain_vt_sampler_feedback_screen_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the screen buffer used to detect visible tiles and what MIP-levels to be loaded.
  • 命令。   设置 resolution of the screen buffer used to detect visible tiles and what MIP-levels to be loaded.
参数:
0 - Quarter
1 - Half (默认)
2 - Full
render_landscape_terrain_vt_sampler_feedback_buffer_resolution
说明/描 述:
  • 变量。   打印当前值resolution of the buffer used to transfer data about tiles and what MIP-levels to be loaded.
  • 命令。   设置 resolution of the buffer used to transfer data about tiles and what MIP-levels to be loaded.
参数:
From 1x1 to 1024x1024 Default: 80x60
render_landscape_terrain_vt_tiles_load_per_frame
说明/描 述:
  • 变量。   打印当前值number of Landscape Terrain tiles loaded per frame.
  • 命令。   设置 number of Landscape Terrain 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 64] - 可用范围
4 - 默认
render_landscape_terrain_vt_tiles_reload_per_frame
说明/描 述:
  • 变量。   打印当前值number of tiles to be reloaded per frame after applying changes to the Landscape Terrain surface.
  • 命令。   设置 number of tiles to be reloaded per frame after applying changes to the Landscape Terrain surface.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 64] - 可用范围
4 - 默认
render_landscape_terrain_vt_tiles_update_per_frame
说明/描 述:
  • 变量。   打印当前值number of tiles passed to the virtual texture of the Landscape Terrain each frame.
  • 命令。   设置 number of tiles passed to the virtual texture of the Landscape Terrain each frame.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[1; 256] - 可用范围
60 - 默认

注意
The commands described below affect only terrain (the ObjectTerrainGlobal class).
render_terrain_global_anisotropy
说明/描 述:
  • 变量。   打印当前值global terrain texture anisotropy level (degree of anisotropic filtering).
  • 命令。   设置 global terrain 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.
参数:
0 - anisotropy level 1
1 - anisotropy level 2
2 - anisotropy level 4 (默认)
3 - anisotropy level 8
4 - anisotropy level 16
render_terrain_global_displacement
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if displacement mapping is enabled for the Global Terrain.
参数:
0 - 关 (默认)
1 -
render_terrain_global_displacement_normal
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if displacement mapping for the Global Terrain rendering uses normals.
参数:
0 - 关 (默认)
1 -
render_terrain_global_holes
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if decal-based holes are enabled for the global terrain.
参数:
0 - 关 (默认)
1 -
render_terrain_global_triplanar
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if triplanar texture mapping is enabled for the Global Terrain. If disabled, planar UV-mapping is used.
参数:
0 - 关 (默认)
1 -

ObjectWaterGlobal RenderingObjectWaterGlobal Rendering#

注意
The commands described below affect only global water (the ObjectWater class).
render_water_anisotropy
说明/描 述:
  • 变量。   打印当前值water texture anisotropy level.
  • 命令。   设置 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
参数:
0 - 1x
1 - 2x (默认)
2 - 4x
3 - 8x
4 - 16x
render_water_environment_probes
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of environment probes on the water surface is enabled.
参数:
0 -
1 - 开 (默认)
render_water_voxel_probes
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if voxel probes are enabled for water rendering.
参数:
0 -
1 - 开 (默认)
render_water_planar_probes
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of Planar Reflection Probes on the water surface is enabled.
参数:
0 -
1 - 开 (默认)
render_water_lights
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of lights on the water surface is enabled.
    注意
    The option doesn't affect the World Light source.
参数:
0 -
1 - 开 (默认)
render_water_opacity_depth
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if depth data for water is written to the opacity buffer.
参数:
0 -
1 - 开 (默认)
render_water_refraction_quality
说明/描 述:
  • 变量。   打印当前值quality of water refraction.
  • 命令。   设置 quality of water refraction.
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (2)
render_water_ssr
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the SSR (Screen Space Reflections) effect is enabled for water.
参数:
0 -
1 - 开 (默认)
render_water_ssr_quality
说明/描 述:
  • 变量。   打印当前值resolution of water SSR (Screen Space Reflections).
  • 命令。   设置 resolution of water SSR (Screen Space Reflections).
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (1)
render_water_ssr_increased_accuracy
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if increased accuracy for the water SSR (Screen Space Reflections). This option reduces visual artifacts by increasing accuracy of the last step.
参数:
0 - 关 (默认)
1 -
render_water_shafts
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if rendering of underwater shafts is enabled.
参数:
0 -
1 - 开 (默认)
render_water_shoreline_wetness
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if the wetness effect for objects near the shoreline is enabled.
参数:
0 -
1 - 开 (默认)
render_water_geometry_preset
说明/描 述:
  • 变量。   打印当前值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:
  • 命令。   设置 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:
参数:
0 - Low (默认)
1 - Medium
2 - High
3 - Ultra
4 - Extreme
5 - Custom
render_water_visible_distance
说明/描 述:
  • 变量。   打印当前值maximum visibility distance for the Global Water.
  • 命令。   设置 maximum visibility distance for the Global Water. The water is visible, as long as the distance between the camera and the water object does not exceed this value.
参数:
[0.0f; inf] - 可用范围
30000.0f - 默认
render_water_geometry_polygon_size
说明/描 述:
  • 变量。   打印当前值size of Global Water polygons.
  • 命令。   设置 size of Global Water 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1000.0f] - 可用范围
0.01f - 默认
render_water_geometry_progression
说明/描 述:
  • 变量。   打印当前值progression of Global Water geometry tessellation.
  • 命令。   设置 progression of Global Water geometry tessellation.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 50.0f] - 可用范围
1.5f - 默认
render_water_geometry_fade_lods
说明/描 述:
  • 变量。   打印当前值intensity of fading between levels of Global Water geometry tessellation.
  • 命令。   设置 intensity of fading between levels of Global Water geometry tessellation. This value can be increased to remove sharp edges between areas with different geometry density.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 1.0f] - 可用范围
0.5f - 默认
render_water_geometry_subpixel_reduction
说明/描 述:
  • 变量。   打印当前值minimum ratio of a polygon size (in screen space) to the size of an area seen in the viewport.
  • 命令。   设置 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.
注意
如果您通过使用设置值 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). Checking the parameter returns the corresponding setting stored in the active preset (default or custom one).
参数:
[0.0f; 50.0f] - 可用范围
6.0f - 默认
render_water_culling_aggressive
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭value indicating if frustum culling optimization is enabled for the Global Water. 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).
参数:
0 -
1 - 开 (默认)
render_water_culling_frustum_padding
说明/描 述:
  • 变量。   打印当前值value, by which the borders of the current frustum are increased.
  • 命令。   设置 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.
参数:
[0.0f; 1.0f] - 可用范围
0.1f - 默认
render_water_culling_oblique_frustum
说明/描 述:
  • 变量。   打印当前值multiplier for the size of viewing frustum used for culling polygons of Global Water object beyond the oblique frustum plane.
  • 命令。   设置 multiplier for the size of viewing frustum used for culling polygons of Global Water object beyond the oblique frustum plane. The higher the value, the more patches will be culled.
参数:
[0.0f; 1.0f] - 可用范围
0.9f - 默认
render_water_waterline_accuracy
说明/描 述:
  • 变量。   打印当前值quality of underwater and waterline determination.
  • 命令。   设置 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.
参数:
以下值之一:
  • 0 - low quality
  • 1 - medium quality
  • 2 - high quality
  • 3 - ultra quality
默认值为 (0)

Output ModesOutput Modes#

render_viewport_mode
说明/描 述:
  • 变量。   打印当前值viewport rendering mode.
  • 命令。   设置 viewport rendering mode. The following modes are available:
    • 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.
    • 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.
    注意
    If the panoramic rendering is enabled, underwater shafts and water line effects will be disabled.
参数:
0 - 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 - Anaglyph
10 - Interlaced
11 - Horizontal
12 - Vertical
render_panorama_fisheye_fov
说明/描 述:
  • 变量。   打印当前值Field of View (in degrees) for the panoramic viewport mode selected at the moment.
  • 命令。   设置 Field of View (in degrees) for the panoramic viewport mode selected at the moment.
    注意
    Available only when the viewport rendering mode (请参阅render_viewport_mode) is set to one of the fisheye panorama modes (5-8).
参数:
[0; 360] - 可用范围
0 - 默认
render_stereo_hidden_area
说明/描 述:
  • 变量。   打印当前值culling mode for pixels that are not visible in VR mode.
  • 命令。   设置 culling mode for pixels that are not visible in VR mode. One of the following values:
    • 0 - hidden area culling is disabled (by default).
    • 1 - OpenVR-based culling mode. Culling is performed using meshes returned by OpenVR.
      注意
      Culling result depends on HMD used.
    • 2 - Custom culling mode. Culling is performed using mesehes returned by OpenVR and an oval or circular mesh determined by custom adjustable parameters (请参阅render_stereo_hidden_area_transform).
    This parameter is used for performance optimization.
参数:
0 - disabled (默认)
1 - OpenVR-based culling mode
2 - Custom culling mode
render_stereo_hidden_area_transform
说明/描 述:
  • 变量。   打印当前值size and offset parameters for a new oval or circular mesh to be used for culling pixels, that are not visible in VR mode.
  • 命令。   设置 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:
    • 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.
      注意
      These components are ignored whenthe hidden area culling mode (请参阅render_stereo_hidden_area) is set to 1
    All components are specified within the [0.0f, 1.0f] range
参数:
(1.0f, 1.0f, 0.0f, 0.0f) - default value
render_stereo_hidden_area_exposure_transform
说明/描 述:
  • 变量。   打印当前值area to be used for exposure calculation, when culling of pixels that are not visible in VR mode (请参阅render_stereo_hidden_area) is enabled.
  • 命令。   设置 area to be used for exposure calculation, when culling of pixels that are not visible in VR mode (请参阅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):
    • 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.
      注意
      These components are ignored when the hidden area culling mode (请参阅render_stereo_hidden_area) is set to 1
    All components are specified within the [0.0f, 1.0f] range.
参数:
(0.6f, 0.6f, 0.0f, 0.0f) - default value

Other SettingsOther Settings#

render_latency
说明/描 述:
  • 变量。   打印当前值maximum number of back buffer frames that a driver is allowed to queue for rendering.
  • 命令。   设置 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 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. 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).
    注意
    Values 1-3 are available for DirectX only.
参数:
0 - sequential rendering CPU-GPU-CPU-GPU...
1 - 1 buffer (默认)
2 - 2 buffers
3 - 3 buffers
render_occlusion_queries
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   打开和关闭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 flag set.
参数:
0 -
1 - 开 (默认)
render_occlusion_queries_num_frames
说明/描 述:
  • 变量。   打印当前值number of frames for additional hardware occlusion query test performed before sending data to GPU.
  • 命令。   设置 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) is enabled.
参数:
[0; 1024] - 可用范围
5 - 默认
render_virtual_resolution
说明/描 述:
  • 变量。   打印当前值virtual screen resolution.
  • 命令。   设置 virtual screen resolution. This option can be used to render video with high resolution (e.g. 8K) regardless of monitor's resolution.
参数:
-1; -1 - default value
render_max_fps
说明/描 述:
  • 变量。   打印当前值maximum FPS value, to which rendering FPS is to be clamped.
  • 命令。   设置 maximum FPS value, to which rendering FPS is to be clamped.
    0 - disables FPS clamping. Both VSync, 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.
参数:
[0.0f; inf] - 可用范围
0.0f - 默认

RenderersRenderers#

OpenGLOpenGL#

Operations on the OpenGL API.

gl_render_renderer
说明/描 述:
  • Command. Prints the information on the graphics card.
gl_render_vendor
说明/描 述:
  • Command. Prints the manufacturer of the OpenGL driver.
gl_render_version
说明/描 述:
  • Command. Prints the version of the OpenGL driver.
gl_render_shading_language
说明/描 述:
  • Command. Prints the version of the OpenGL shading language.
gl_render_extensions
说明/描 述:
  • Command. Prints OpenGL render extensions.
gl_render_skip_errors配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables skipping of OpenGL errors.
参数:
0 - 关 (默认)
1 -

OpenAL SettingsOpenAL Settings#

Operations on the OpenAL API.

al_sound_renderer
说明/描 述:
  • Command. Prints the information on the sound card.
al_sound_vendor
说明/描 述:
  • Command. Prints the manufacturer of the OpenAL driver.
al_sound_version
说明/描 述:
  • Command. Prints the version of the OpenAL driver.
al_sound_extensions
说明/描 述:
  • Command. Prints the available OpenAL sound extensions.
alc_sound_extensions
说明/描 述:
  • Command. Prints OpenAL context sound extensions.
al_sound_skip_errors
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables skipping of OpenAL errors.
参数:
0 - 关 (默认)
1 -

PluginsPlugins#

Operations on external plugins.

plugin_load
说明/描 述:
  • Command. Loads an external plugin.
参数:
External plugin name
plugin_reload
说明/描 述:
  • Command. Reloads an external plugin.
参数:
External plugin name
plugin_quit
说明/描 述:
  • Command. Quits and unloads an external plugin.
参数:
External plugin name

Bake LightingBake Lighting#

Operations on the Bake Lighting tool.

bake_lighting_bounces
说明/描 述:
参数:
[1; 32] - 可用范围
1 - 默认
bake_lighting_samples_per_frame
说明/描 述:
  • 变量。   打印当前值number of voxels computed and visualized per single frame during bake lighting process (higher values cause longer UI response, but speed up calculations).
  • 命令。   设置 number of voxels computed and visualized per single frame during bake lighting process (higher values cause longer UI response, but speed up calculations).
参数:
[1; 500] - 可用范围
10 - 默认
bake_lighting_voxel_size_multiplier
说明/描 述:
参数:
[0.0f; 8.0f] - 可用范围
1.0f - 默认
bake_lightmap_viewport_mask
说明/描 述:
  • Variable. Prints the current viewport mask for the lightmapper.
  • Command. Assigns a new viewport mask for the lightmapper. For a light or surface to contribute to static GI, their viewport masks should match the baking viewport mask.
参数:
Viewport mask
bake_lightmap_zfar
说明/描 述:
参数:
[0.0f; inf] - 可用范围
1000.0f - 默认
bake_lightmap_quality
说明/描 述:
  • 变量。   打印当前值global baking quality for lightmaps.
  • 命令。   设置 global baking quality for lightmaps.
参数:
0 - Draft
1 - Low
2 - Medium (默认)
3 - High
4 - Ultra
bake_lighting_start
说明/描 述:
  • Command. Starts bake lighting.
bake_lighting_stop
说明/描 述:
  • Command. Stops bake lighting.

ScreenshotsScreenshots#

Operations on screenshots.

screenshot_extension配置文件: *.user
说明/描 述:
  • 变量。   打印当前值screenshot format.
  • 命令。   设置 screenshot format.
参数:
Extension for screenshot files: "png", "jpg", "dds", "tga", etc... ("tga" is used by default)
screenshot
说明/描 述:
  • Command. Takes a screenshot.
注意
A screenshot is saved in the bin/screenshots directory by default. You can specify another directory.
参数:
Path to the folder the screenshots will be saved in (optional)

General InformationGeneral Information#

Memory InfoMemory Info#

Operations, representing information on the system memory.

memory_info
说明/描 述:
  • Command. Print information on the memory usage:
    • Heap usage - size of the heap memory
    • Memory usage - size of the used system memory
    • Allocations - number of allocations

CPU InfoCPU Info#

Operations, representing information on the CPU.

cpu_info
说明/描 述:
  • Command. Prints information on the CPU and instruction set supported by it.
cpu_frequency
说明/描 述:
  • Command. Prints the CPU frequency in MHz.
cpu_count
说明/描 述:
  • Command. Prints the number of available CPUs.
cpu_threads
说明/描 述:
  • 变量。   打印当前值CPU threads available.
  • 命令。   设置 CPU threads available.
参数:
[0; 1024] - 可用范围
0 - 默认
cpu_hyper_threading
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables CPU hyper threading.
参数:
0 - 关 (默认)
1 -

System InfoSystem Info#

Operations representing information on the system.

binary_info
说明/描 述:
  • Command. Prints information on the engine binary.
system_info
说明/描 述:
  • Command. Prints information on the operating system and the engine build version.
system_memory
说明/描 述:
  • Command. Prints the system memory size in Mbytes.

GPU InfoGPU Info#

Operations representing information on the GPU.

gpu_info
说明/描 述:
  • Command. Prints the video card and driver versions.
gpu_memory
说明/描 述:
  • Command. Prints the video memory size in Mbytes.
gpu_count
说明/描 述:
  • Command. Prints the number of available GPUs.

MiscellaneousMiscellaneous#

Miscellaneous commands.

gpu_thread_priority
说明/描 述:
  • 变量。   打印当前值GPU thread priority for the engine.
  • 命令。   设置 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.
参数:
[-7; 7] - 可用范围
7 - 默认
process_priority配置文件: *.boot
说明/描 述:
  • 变量。   打印当前值engine process priority.
  • 命令。   设置 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.
参数:
0 - idle
1 - normal (默认)
2 - high
3 - real-time
log_stdout配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables log messages printing in stdout.
    注意
    Logging to stdout may significantly affect performance, so switch this option off, when you don't need it. You can use log_file for debugging purposes, as it is more performance-friendly.
参数:
0 -
1 - 开 (默认)
log_file配置文件: *.boot
说明/描 述:
  • 变量。   打印一个值,该值指示是否启用了以下命令控制的选项。
  • 命令。   Enables log messages saving in the Engine's log file.
    注意
    This option is used for debugging. Do not turn it off if you need to debug something.
参数:
0 -
1 - 开 (默认)
最新更新: 2023-12-19
Build: ()