Broad improvements to docs and pimax support

This commit is contained in:
BabbleBones 2024-07-19 16:45:29 -04:00
parent f88536c4c7
commit 798206eaac
10 changed files with 58 additions and 37 deletions

View file

@ -1,5 +1,5 @@
---
weight: 70
weight: 49
title: Envision
---
@ -25,6 +25,8 @@ Envision is still to be considered alpha-quality and highly experimental.
You can download the latest Appimage snapshot from [GitLab Pipelines](https://gitlab.com/gabmus/envision/-/pipelines).
**Please note that WiVRn will not work properly by AppImage, if you utilize the AppImages to run WiVRn you must extract the contents of the AppImage and then execute the Envision binary.**
## 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](/docs/steamvr).
@ -35,19 +37,7 @@ The following resources can be entered into your envision profile repo and branc
### 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`
Full body is now provided by default in Monado & OpenComposite through the XR_MNDX_xdev_space OpenXR vendor extension. This allows any tracked "xdev" in Monado to be forwarded as a raw pose without bindings to applications. OpenComposite exposes these as fake vive FBT trackers for use.
### WMR Controller tracking

View file

@ -1,5 +1,5 @@
---
weight: 300
weight: 53
title: Valve Index Camera Passthrough
---

View file

@ -1,5 +1,5 @@
---
weight: 100
weight: 50
title: Monado
---
@ -8,6 +8,8 @@ title: Monado
- [Monado home page](https://monado.freedesktop.org/)
- [Monado GitLab repository](https://gitlab.freedesktop.org/monado/monado)
![The Legendary Big M](https://gitlab.freedesktop.org/uploads/-/system/project/avatar/2685/monado_icon_medium.png?width=128)
> Monado is an open source XR runtime delivering immersive experiences such as VR and AR on mobile, PC/desktop, and other devices. Monado aims to be a complete and conformant implementation of the OpenXR API made by Khronos. The project is currently being developed for GNU/Linux and aims to support other operating systems such as Windows in the near future.
Essentially, Monado is an open source OpenXR implementation, it can be used as an alternative to SteamVR.
@ -28,3 +30,9 @@ Monado is made for PCVR headsets, if you have a standalone headset you can check
To use Monado as the OpenXR runtime with Steam, or if you're planning to use the SteamVR lighthouse driver in Monado, make sure to [run the room setup first](/docs/steamvr/).
In order to use the SteamVR lighthouse driver in Monado, you just need to set the environment variable `STEAMVR_LH_ENABLE=true`.
OpenComposite is REQUIRED to operate Monado in conjunction with Steam games. Proton requires a functional OpenVR API to utilize OpenXR at all and Proton itself is required for VR to function as normal wine does not carry any of the needed patches nor does "protonified" wine something like Lutris would provide.
## Envision
[Envision](/docs/envision/) provides fairly low barrier setup and development of both Monado and OpenComposite on most any modern distro.

View file

@ -13,4 +13,6 @@ title: OpenComposite
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](https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html).
OpenComposite is required for Steam Play games to work in VR regardless of API. Due to the number of confounding factors surrounding setup, sandboxing, and more quirks; we recommend you use Envision to setup and manage your VR.
Contributions to improve the OpenVR to OpenXR mapping are welcome.

View file

@ -1,6 +1,6 @@
---
title: Stardust XR
weight: 60
weight: 52
---
# Stardust XR

View file

@ -1,5 +1,5 @@
---
weight: 200
weight: 50
title: WiVRn
---

View file

@ -1,5 +1,5 @@
---
weight: 300
weight: 51
title: WlxOverlay-S
---