OpenXR Toolkit (upscaling, world scale, hand tracking...) - Release thread

There are a few updates coming up in version 1.1.1 in the next few days. Most of them are targeted for OpenComposite support (so not Flight Simulator).

There are however a few noteworthy updates to requests from this community:

  • Fixes to the menu display, which should make the menu work with canted displays (eg: Pimax)
  • Option to customize the position of the FPS overlay
  • Configure whether to take screenshot for left, right or both eyes
  • Add zoom
  • Add a command-line mode to the companion app, which can be used to change some settings externally.

For that last one, it should enable 2 things:

  1. Ability to create presets for the Appearance settings.
  2. Create hotkeys, bind to joystick, or voice command for certain actions (eg: toggle sunglasses, turn foveated rendering on/off).

Here is a preview of how the command-line will work:

Usage: C:\Program Files\OpenXR-Toolkit\companion.exe
    [app <name>]
    [-sunglasses <off|light|dark|trunite>]
    [-post-process <[0,1]>]
    [-contrast <[0,100]>]
    [-brightness <[0,100]>]
    [-exposure <[0,100]>]
    [-saturation <[0,100]>]
    [-vibrance <[0,100]>]
    [-highlights <[0,100]>]
    [-shadows <[0,100]>]
    [-gain-r <[0,100]>]
    [-gain-g <[0,100]>]
    [-gain-b <[0,100]>]
    [-world-scale <[0,1000]>]
    [-zoom <[1,150]>]
    [-reprojection-rate <unlocked|1/2|1/3|1/4>]
    [-foveated-rendering <toggle>]
    [-overlay <toggle>]

When no app is specified, the currently running app is used.
Use syntax <+N> to add value N to integral and decimal values (N can be negative)
Use syntax <+N> to cycle by step N through enumeration values (with automatic wraparound)

Examples:
 companion.exe -brightness 50.5 -contrast 45.8
   Set brightness and contrast values for the currently running app
 companion.exe -sunglasses +1
   Cycle through sunglasses mode for the currently running app
 companion.exe -world-scale +-10
   Decrease world scale by 10% for the currently running app
 companion.exe -overlay toggle
   Toggle the overlay on/off for the currently running app
 companion.exe app FS2020 dump
   Dump settings for app 'FS2020' (Flight Simulator 2020)

The dump option can be used to generate a command-line based on the current option values (eg: as you set from the menu in-game), so that you can copy/paste it directly:

> companion.exe dump
C:\Program Files\OpenXR-Toolkit\companion.exe app HelloXR -sunglasses light -post-process 1 -contrast 50 -brightness 0.1 -exposure 50 -saturation 50 -vibrance 0 -highlights 100 -shadows 0 -gain-r 50 -gain-g 50 -gain-b 50 -world-scale 101 -reprojection-rate 1/4

This isn’t the most integrated solution, but it should enable many scenarios. It will require you to install a 3rd party application (autohotkey was suggested for example, I’ve also heard of VoiceAttack before) and configure it to invoke the command-line. Hopefully this is simple-enough for most folks, and we can write a good guide to help with it.

You’ll also note that not all settings can be controlled, and that is a deliberate choice. Settings requiring session restart are not included for example. Maybe we’ll extend the list in the future.

24 Likes