From c2c74fa3849140a2d89065a116cbf18528ba741d Mon Sep 17 00:00:00 2001 From: Sgeo Date: Mon, 20 Mar 2017 23:18:01 -0400 Subject: [PATCH 1/3] Create README.md --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ae81a19 --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# Guardian2Chaperone + +## Purpose + +This utility transfers the Oculus Room Setup data to SteamVR for Oculus Rift. It moves the SteamVR floor to match the Oculus floor, the SteamVR play area to Oculus play area, and makes the Chaperone bounds match the Oculus bounds [and makes the SteamVR bounds invisible] + +## Usage + +Set up Oculus Room Setup, then run this utility. You can run this utility instead of running SteamVR Room Setup + +## Notes + +* This code makes a lot of assumptions that I believe are valid, but I am not 100% certain if they are valid for all configurations, and if they will be valid in the future. + +* This utility has been observed to cause SteamVR to freeze if run while SteamVR is running. Just close SteamVR via the Universal Menu and start it again. + +* This turns the SteamVR bounds invisible. Keep Oculus Guardian on, or make the SteamVR bounds visible in the SteamVR customization menu. The SteamVR bounds will match Oculus bounds, but might look ugly. + +## Credits + +* Oculus's GuardianSystemDemo used as a starting point, but almost none of that code remains. + +* OpenVR-Advanced for helping me understand the OpenVR API functions required. From 35095af27531ee233fc934df0294452d776aadbe Mon Sep 17 00:00:00 2001 From: Sgeo Date: Mon, 20 Mar 2017 23:26:10 -0400 Subject: [PATCH 2/3] Update README.md Another notice --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index ae81a19..32653f5 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,8 @@ Set up Oculus Room Setup, then run this utility. You can run this utility instea * This turns the SteamVR bounds invisible. Keep Oculus Guardian on, or make the SteamVR bounds visible in the SteamVR customization menu. The SteamVR bounds will match Oculus bounds, but might look ugly. +* The Oculus play space may be smaller than SteamVR's usual minimum play space. The utility will set the SteamVR play space to match Oculus, but the utility will give no notice that this has occurred, and I cannot predict how SteamVR applications will react. + ## Credits * Oculus's GuardianSystemDemo used as a starting point, but almost none of that code remains. From b38f8b780c5e6a22bbebda8b3b2c1acd9941d9e5 Mon Sep 17 00:00:00 2001 From: Sgeo Date: Tue, 21 Mar 2017 00:38:42 -0400 Subject: [PATCH 3/3] Update README.md Get connected first. And no Vives. --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 32653f5..523dbb8 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,8 @@ Set up Oculus Room Setup, then run this utility. You can run this utility instea ## Notes +* Your Rift and cameras should probably be connected before running this. + * This code makes a lot of assumptions that I believe are valid, but I am not 100% certain if they are valid for all configurations, and if they will be valid in the future. * This utility has been observed to cause SteamVR to freeze if run while SteamVR is running. Just close SteamVR via the Universal Menu and start it again. @@ -18,6 +20,8 @@ Set up Oculus Room Setup, then run this utility. You can run this utility instea * The Oculus play space may be smaller than SteamVR's usual minimum play space. The utility will set the SteamVR play space to match Oculus, but the utility will give no notice that this has occurred, and I cannot predict how SteamVR applications will react. +* I have no idea what happens if a Vive user using Revive runs this. It might be entertaining, but I doubt of any practical use. + ## Credits * Oculus's GuardianSystemDemo used as a starting point, but almost none of that code remains.