lvra.gitlab.io/content/docs/fossvr/envision/_index.md
2024-05-13 14:34:56 +00:00

3.1 KiB

weight title
70 Envision

Envision

Envision is a graphical app that acts as an orchestrator to get a full Monado or WiVRn setup up and running with a few clicks.

Envision attempts to construct a working runtime with both a native OpenXR and an OpenVR API, provided by OpenComposite, for client aplications to utilize. Please note the OpenVR implementation is incomplete and contains only what's necessary to run most games for compatibility. If you plan to implement software, utilize the OpenXR API, specification here.

{{< hint danger >}} Warning

Envision is still to be considered alpha-quality and highly experimental. {{< /hint >}}

You can download the latest Appimage snapshot from GitLab Pipelines.

Room Setup

If you're planning to use the SteamVR lighthouse driver (with Index or Vive HMDs, or other lighthouse tracked HMDs), you'll need to go through the SteamVR room setup. You can do that from SteamVR, directly from Envision or manually by running the appropriate scripts. More info in the SteamVR page.

Experimental feature settings

The following resources can be entered into your envision profile repo and branch settings to enable early access to code before its fully upstream in monado itself. Simply edit your profile with these settings and rebuild to enable these feature sets.

Full body lighthouse tracking

These patches enable fairly hacky full body support for steamvr_lh and survive drivers in monado. Both of these must be used in conjuction or your XR application will crash or hang.

For the Envision xr service settings:

Repo https://gitlab.freedesktop.org/BabbleBones/monado/

Branch vive_tracker3

For the Envision OpenComposite settings:

Repo https://gitlab.com/BabbleBones/OpenOVR

Branch htcx-fbt

WMR Controller tracking

This enables positional tracking for WMR controllers in full 6dof

For the Envision xr service settings:

Repo https://gitlab.freedesktop.org/thaytan/monado

Branch dev-constellation-controller-tracking

Basalt persistent space map

This allows for the saving and retreieval of the basalt SLAM tracking map. The upshot of which is a persistent space origin, floor, and room orientation on SLAM tracked headsets such as WMR. Consider pairing this with LOVR playspace to set room boundaries.

For the Envision Basalt settings:

Repo https://github.com/CIFASIS/basalt-with-persistent-map

Branch xrtslam

Experimental Pimax support branch

Major WIP. Allows certain Pimax HMDs to function with Monado.

For the Envision xr service settings:

Repo https://gitlab.freedesktop.org/Coreforge/monado/

Branch pimax