This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Basics
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_debug_modeConfig file: *.boot
Description:
  • Variable.   Prints the current debug mode for VR API.
  • Command.   Sets the debug mode for VR API.
    Notice
    When the debug mode is enabled, a severe slowdown may occur.
Arguments:
0 - release VR context (no debug) (by default)
1 - debug VR context
2 - debug VR context with break on error (only on debug binaries)
vr_reset_zero_pose
Description:
  • Command. Sets the zero pose to the current tracker position.
vr_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_timeConfig file: *.boot
Description:
  • Variable.   Prints the current exposure time value that is valid for the connected device.
  • Command.   Sets the exposure time value that is valid for the connected device.
Arguments:
  • 1 - exposure time value equal to 91 ms
  • 2 - exposure time value equal to 125 ms (default)
  • 3 - exposure time value equal to 250 ms
  • 4 - exposure time value equal to 500 ms
  • 5 - exposure time value equal to 1000 ms
  • 6 - exposure time value equal to 2000 ms
  • 7 - exposure time value equal to 4000 ms
  • 8 - exposure time value equal to 8000 ms
vr_mixed_reality_camera_exposure_time_mode
Description:
  • Variable.   Prints the current exposure adjustment mode for the camera.
  • Command.   Sets the exposure adjustment mode for the camera.
Arguments:
0 - exposure adjustment is disabled
1 - automatic exposure adjustment (by default)
2 - manual exposure adjustment
vr_mixed_reality_camera_white_balanceConfig file: *.boot
Description:
  • Variable.   Prints the current white balance correction value that is valid for the connected device.
  • Command.   Sets the white balance correction value that is valid for the connected device.
Arguments:
  • 1 - white balance value equal to 2000 K
  • 2 - white balance value equal to 3000 K
  • 3 - white balance value equal to 3500 K
  • 4 - white balance value equal to 4200 K
  • 5 - white balance value equal to 5000 K
  • 6 - white balance value equal to 5400 K
  • 7 - white balance value equal to 6500 K (default)
  • 8 - white balance value equal to 8000 K
  • 9 - white balance value equal to 12000 K
vr_mixed_reality_camera_white_balance_mode
Description:
  • Variable.   Prints the current white balance adjustment mode for the camera.
  • Command.   Sets the white balance adjustment mode for the camera.
Arguments:
0 - white balance adjustment is disabled
1 - automatic white balance adjustment (by default)
2 - manual white balance adjustment
vr_mixed_reality_camera_isoConfig file: *.boot
Description:
  • Variable.   Prints the current ISO value for the camera.
  • Command.   Sets the ISO value for the camera.
Arguments:
  • 1 - ISO value equal to 100
  • 2 - ISO value equal to 200
  • 3 - ISO value equal to 400
  • 4 - ISO value equal to 800 (default)
  • 5 - ISO value equal to 1600
  • 6 - ISO value equal to 3200
  • 7 - ISO value equal to 6400
vr_mixed_reality_camera_iso_mode
Description:
  • Variable.   Prints the current ISO adjustment mode for the camera.
  • Command.   Sets the ISO adjustment mode for the camera.
Arguments:
0 - ISO adjustment is disabled
1 - automatic ISO adjustment (by default)
2 - manual ISO adjustment
vr_mixed_reality_camera_flicker_compensation
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.
vr_mixed_reality_camera_vst_reprojection_mode
Description:
  • Variable.   Prints the current reprojection mode of VST.
  • Command.   Sets the reprojection mode of VST.
Arguments:
0 - reprojection of VST is disabled (default). (by default)
1 - automatic reprojection mode of VST (the Depth buffer is used for reprojection)
2 - manual reprojections mode of VST
vr_mixed_reality_camera_vst_reprojection_distance
Description:
  • Variable.   Prints the current static distance in meters used to control VST reprojection.
  • Command.   Sets the static distance in meters used to control VST reprojection.
Arguments:
[0.0f; 1000.0f] - available range
0.0f - by default
Last update: 2024-08-16
Build: ()