This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Rendering
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

VR Console Commands and Variables

After VR initialization, a set of VR-related console commands will become available.

Common VR Settings
#

vr_info
Description:
  • Command. Prints the information on the current VR API and the connected VR devices — HMD, controllers, and others. For the controllers, it also displays the battery level (if available).
vr_reset_zero_pose
Description:
  • Command. Sets the zero pose to the current tracker position.
vr_render_enabledConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if rendering into the head-mounted display is enabled.
Arguments:
0 - disabled (by default)
1 - enabled
vr_peripheral_rendering_mode_enabledConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if the peripheral rendering mode is enabled. In this mode, the HMD has two context (peripheral) and two focus displays. You can disable two additional viewports to improve peformance.
    Notice
    This feature is available for the Varjo devices only.
Arguments:
0 - disabled (by default)
1 - enabled
vr_service_init_timeoutConfig file: *.boot
Description:
  • Variable.   Prints the current VR initialization timeout in number of attempts. The engine attempts to run VR Service and has to wait for its initialization.
  • Command.   Sets the VR initialization timeout in number of attempts. The engine attempts to run VR Service and has to wait for its initialization.
Arguments:
[0; 200] - available range
60 - by default
vr_mirror_modeConfig file: *.boot
Description:
  • Variable.   Prints the current mirror mode that defines how the mirrored image (i.e. VR image) will be displayed in the target window.
  • Command.   Sets the mirror mode that defines how the mirrored image (i.e. VR image) will be displayed in the target window.
Arguments:
0 - black screen (no image is displayed).
1 - image rendered for the left eye.
2 - image rendered for the right eye.
3 - stereo image (both the left and right eyes). (by default)
vr_window_modeConfig file: *.boot
Description:
  • Variable.   Prints the current window mode that defines which window will display the mirrored image (i.e. VR image).
  • Command.   Sets the window mode that defines which window will display the mirrored image (i.e. VR image).
Arguments:
0 - mirroring is disabled.
1 - main window displays the mirrored image. (by default)
vr_tracking_spaceConfig file: *.boot
Description:
  • Variable.   Prints the current zero pose of the tracking origin.
  • Command.   Sets the zero pose of the tracking origin.
Arguments:
0 - seated.
1 - standing. (by default)
2 - raw (uncalibrated).
vr_head_tracking_position_enabledConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if the head position is locked.
Arguments:
0 - disabled
1 - enabled (by default)
vr_head_tracking_rotation_enabledConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if the head rotation is locked.
Arguments:
0 - disabled
1 - enabled (by default)
vr_motion_predictionConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if motion prediction in the Varjo headsets is enabled. When enabled, the engine submits the velocity value from the GBuffer to the Varjo Composer.
Arguments:
0 - disabled (by default)
1 - enabled
vr_motion_prediction_velocity_precisionConfig file: *.boot
Description:
  • Variable.   Prints the current factor of velocity scale before packing a floating point value into a 2x8 bit unsigned integer (uint).
    Notice
    This feature is available for the Varjo devices only.
  • Command.   Sets the factor of velocity scale before packing a floating point value into a 2x8 bit unsigned integer (uint).
    Notice
    This feature is available for the Varjo devices only.
Arguments:
[eps; inf] - available range
32.0f - by default
vr_motion_prediction_velocity_time_deltaConfig file: *.boot
Description:
  • Variable.   Prints the current factor for optimizing between fast and slow-moving objects. A smaller number works better for fast-moving objects, and vice versa.
    Notice
    This feature is available for the Varjo devices only.
  • Command.   Sets the factor for optimizing between fast and slow-moving objects. A smaller number works better for fast-moving objects, and vice versa.
    Notice
    This feature is available for the Varjo devices only.
Arguments:
[eps; inf] - available range
1.0f / 60.0f - by default
vr_foveated_rendering_enabledConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if foveated rendering is enabled. Foveated rendering makes use of the eye tracking functionality in the Varjo headsets to improve performance by reducing the image quality in peripheral areas where the user is not looking. Foveation allows applications to render fewer pixels and achieve a better VR experience.
    Notice
    This feature is available for the Varjo devices only.
Arguments:
0 - disabled
1 - enabled (by default)

Mixed Reality Settings
#

vr_mixed_reality_chroma_key_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if chroma keying is enabled. VST capturing from HMD cameras must be enabled.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_depth_test_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if depth buffer submission is enabled. VST capturing from HMD cameras must be enabled.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_alpha_blend_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if alpha blending is enabled. This option is used for blending VR and AR images using the alpha channel. VST capturing from HMD cameras must be enabled and the screen precision must be 1.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_video_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if the video signal from the real-world view from the front-facing HMD-mounted cameras is enabled. The real-world view is used for combining virtual and real-world elements to create an immersive experience in mixed reality.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_depth_test_range_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if the depth test range usage is enabled. Use the depth test range (Depth Test Near Z, Depth Test Far Z) to control the range for which the depth test is evaluated.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_depth_test_range
Description:
  • Variable.   Prints the current depth test range as a two-component vector (the near and far planes). The depth test range usage must be enabled.
  • Command.   Sets the depth test range as a two-component vector (the near and far planes). The depth test range usage must be enabled.
Arguments:
vec2(0.0f, 1.0f) - default value
vr_mixed_reality_camera_exposure_time
Description:
exposure time value that is valid for the connected device.
vr_mixed_reality_camera_exposure_time_mode
Description:
  • Variable.   Prints the current exposure adjustment mode for the camera.
  • Command.   Sets the exposure adjustment mode for the camera.
Arguments:
0 - exposure adjustment is disabled
1 - automatic exposure adjustment (by default)
2 - manual exposure adjustment
vr_mixed_reality_camera_white_balance
Description:
white balance correction value that is valid for the connected device.
vr_mixed_reality_camera_white_balance_mode
Description:
  • Variable.   Prints the current white balance adjustment mode for the camera.
  • Command.   Sets the white balance adjustment mode for the camera.
Arguments:
0 - white balance adjustment is disabled
1 - automatic white balance adjustment (by default)
2 - manual white balance adjustment
vr_mixed_reality_camera_iso
Description:
ISO value for the camera.
vr_mixed_reality_camera_iso_mode
Description:
  • Variable.   Prints the current ISO adjustment mode for the camera.
  • Command.   Sets the ISO adjustment mode for the camera.
Arguments:
0 - ISO adjustment is disabled
1 - automatic ISO adjustment (by default)
2 - manual ISO adjustment
vr_mixed_reality_camera_flicker_compensation
Description:
flicker compensation value for the camera. This is useful when using the HMD indoors with mostly artificial light bulbs, which flicker at the frequency of 50Hz or 60Hz and can cause visual flicker artifacts on the video see through image. The correct setting depends on the underlying power grid's frequency. For example, in most parts of Africa/Asia/Australia/Europe the frequency is 50 Hz and in most parts of North and South America 60 Hz.
vr_mixed_reality_camera_sharpness
Description:
  • Variable.   Prints the current sharpness filter power value for the camera.
  • Command.   Sets the sharpness filter power value for the camera.
Arguments:
[0; 10] - available range
0 - by default
vr_mixed_reality_view_offset
Description:
  • Variable.   Prints the current eyes view offset (where eye camera should be positioned when using Mixed Reality):
    • 0 for physical eye position
    • 1 for VST camera position
  • Command.   Sets the eyes view offset (where eye camera should be positioned when using Mixed Reality):
    • 0 for physical eye position
    • 1 for VST camera position
Arguments:
[0.0; 1.0] - available range
0.0 - by default
vr_mixed_reality_marker_tracking_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if marker tracking is enabled.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_marker_visualizer_enabledConfig file: *.boot
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating the marker visualizer is enabled.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_blend_masking_mode
Description:
  • Variable.   Prints the current mode of the Blend Control Mask that can be used to extend or restrict the chroma key mask or to control the depth testing against the estimated video depth.
  • Command.   Sets the mode of the Blend Control Mask that can be used to extend or restrict the chroma key mask or to control the depth testing against the estimated video depth.
Arguments:
0 - Disabled (masking mode is disabled). (by default)
1 - Restrict Video to Mask (show the video pass-through image (VST) in the mask; can be used with chroma key)
2 - Restrict VR to Mask (show VR in the mask; can be used with chroma key)
3 - Restrict VR to Chromakey reduced by Mask (show VR in the mask and chroma elsewhere; requires chroma key)
vr_mixed_reality_blend_masking_debug_enabled
Description:
  • Variable.   Prints a value indicating if the option controlled by the command below is enabled.
  • Command.   Toggles the value indicating if blend masking debug visualization is enabled. The blend masking mode must be enabled.
Arguments:
0 - disabled (by default)
1 - enabled
vr_mixed_reality_cubemap_mode
Description:
  • Variable.   Prints the current mode defining the way the AR texture is set for the environment.
  • Command.   Sets the mode defining the way the AR texture is set for the environment.
Arguments:
0 - cubemap streaming from AR cameras is disabled.
1 - environment texture substitutes the sky.
2 - the first environment preset defines the way the AR texture is set for the environment. (by default)
3 - the second environment preset defines the way the AR texture is set for the environment.
4 - the third environment preset defines the way the AR texture is set for the environment.
vr_mixed_reality_cubemap_ggx_quality
Description:
  • Variable.   Prints the current quality of the generated GGX mips for the AR cubemap.
  • Command.   Sets the quality of the generated GGX mips for the AR cubemap.
Arguments:
0 - low
1 - medium (by default)
2 - high
3 - ultra
vr_mixed_reality_override_color_correction_mode
Description:
  • Variable.   Prints the current color correction mode for the stream from the AR cameras.
  • Command.   Sets the color correction mode for the stream from the AR cameras.
Arguments:
0 - correction is disabled. (by default)
1 - exposure correction for the stream from the AR cameras.
2 - exposure and white balance correction for the stream.
Last update: 2024-02-27
Build: ()