diff --git a/docs/babbleofficaltracker/babbleofficaltracker.mdx b/docs/babbleofficaltracker/babbleofficaltracker.mdx index 1befee9..832c5f4 100644 --- a/docs/babbleofficaltracker/babbleofficaltracker.mdx +++ b/docs/babbleofficaltracker/babbleofficaltracker.mdx @@ -9,7 +9,7 @@ This guide applies to the Official Babble Tracker, and should cover DIY versions :::info -If you'd like to use your tracker in *Wireless* mode, follow this [guide.](docs/babbleofficaltracker/babbleofficaltrackerwireless.mdx) +**If you'd like to use your tracker in _Wireless_ mode, follow this [guide.](docs/babbleofficaltracker/babbleofficaltrackerwireless.mdx)** ::: ## Getting Started ### Hardware Setup diff --git a/docs/babbleofficaltracker/babbleofficaltrackerwireless.mdx b/docs/babbleofficaltracker/babbleofficaltrackerwireless.mdx index 804fbaf..2404e35 100644 --- a/docs/babbleofficaltracker/babbleofficaltrackerwireless.mdx +++ b/docs/babbleofficaltracker/babbleofficaltrackerwireless.mdx @@ -27,7 +27,7 @@ title: Wireless Setup #### macOS/Linux - Currently, we do not offer installers for these platforms. You will need to build these from source. - For assistance building Babble Avalonia on these platforms, please contact us in our discord server. - - Our [Legacy App](docs\software\babbleApps\babble-app.mdx) can be run from our [installer scripts](https://github.com/project-Babble/projectBabble/?tab=readme-ov-file#macos-and-linux) on the Github + - Our [Legacy App](docs\babbleofficaltracker\legacySetup.mdx) can be run from our [installer scripts](https://github.com/project-Babble/projectBabble/?tab=readme-ov-file#macos-and-linux) on the Github ### Mode Selection diff --git a/docs/software/babbleApps/Eballs.mdx b/docs/software/babbleApps/Eballs.mdx new file mode 100644 index 0000000..44f359e --- /dev/null +++ b/docs/software/babbleApps/Eballs.mdx @@ -0,0 +1,64 @@ +--- +title: Eballs +sidebar_position: 2 +--- + +# Eballs + +:::info +Eballs is only able to be used with headsets that have eye tracking hardware either natively or with an addon like ETVR +::: + +## Setting Up Eye Cameras +### Camera Selection + Select your left and right eye cameras from the dropdown in Baballonia + +![eyeselection](/img/eballs/eyeselect.png) + +### Cropping + In the majority of cases you should leave your eye cameras uncropped + 1) Go to cropping mode and click "Select Left/Right Frame" + 2) Return to tracking mode + +![eyecrop](/img/eballs/eyecrop.png) + +### Special Cases + #### Bigscreen Beyond 2E + The 2E's eye camera stream, called Bigeye, is a single feed containing both left and right eye + + If Baballonia doesn't automatically seperate them use the following steps + 1) In the Left Eye Camera, enter cropping mode and click "Select Left Frame" + 2) In the Right Eye Camera, enter cropping mode and click "Select Right Frame" + #### Single eye setups + If using a single camera for eye tracking you only need to input the feed into one eye, Baballonia will handle the rest! +## Eye Tracking Calibration +### Getting started + #### Setting up your calibration enviroment + You **Must** be facing the forward direction of your playspace in SteamVR + - in the steamvr home menu press the "Recenter" button + + ![steamvr](/img/eballs/steamvr.png) + + It is *highly* reccomended to do the calibration steps in a dark enviroment clear of anything that might distract you or catch your eye such as the default SteamVR enviroment + #### Starting Calibration + :::info + Starting calibration in baballonia will launch the overlay in your VR view and begin calibration, make sure you're ready to begin beforehand + ::: + To begin calibrating click the "Eye Calibration" button in baballonia + ![eyecalibration](/img/eballs/calstart.png) +### Gaze Calibration +:::info +For many headsets the quality and reliablility of eye tracking can be improved by slightly shifting the headset around during calibration +::: + During gaze calibration you should remain focused on the dot at all times + There are a few reccomended movements to do while looking at the dot for optimal calibration + #### 1) The Ring + Move your head so the dot is rotated around the entire edge of your field of view + #### 2) The Grid + Move your head in a side to side motion like tracing all the lines on graph paper while keeping the dot within the bounds of the view + #### 3) The Cross + Move your head so the dot moves to the edges of the view in the vertical and horizontal directions +### Blink Calibration + During blink calibration you must keep your eyes closed until it finishes, though feel free to make expressions as this helps with robust blink detection + + Alternating between relaxed and tightly closed eyes also helps with correct detection \ No newline at end of file diff --git a/docs/software/babbleApps/baballonia.mdx b/docs/software/babbleApps/baballonia.mdx index cd7b5b5..2a3d9be 100644 --- a/docs/software/babbleApps/baballonia.mdx +++ b/docs/software/babbleApps/baballonia.mdx @@ -1,6 +1,6 @@ --- title: Baballonia -sidebar_position: 2 +sidebar_position: 1 --- # Baballonia diff --git a/docs/software/software.mdx b/docs/software/software.mdx index 7b419e0..eed913e 100644 --- a/docs/software/software.mdx +++ b/docs/software/software.mdx @@ -8,5 +8,5 @@ sidebar_position: 2 ## Setup Getting started with the Babble App is as easy as 1-2-3! -- For the legacy desktop app, [click here](docs\software\babbleApps\babble-app.mdx) +- For the legacy desktop app, [click here](docs\babbleofficaltracker\legacySetup.mdx) - For the newer desktop app "Baballonia", [click here](docs\software\babbleApps\baballonia.mdx) \ No newline at end of file diff --git a/static/img/Eballs/Steamvr.png b/static/img/Eballs/Steamvr.png new file mode 100644 index 0000000..5381b27 Binary files /dev/null and b/static/img/Eballs/Steamvr.png differ diff --git a/static/img/Eballs/calstart.png b/static/img/Eballs/calstart.png new file mode 100644 index 0000000..3074c1a Binary files /dev/null and b/static/img/Eballs/calstart.png differ diff --git a/static/img/Eballs/eyecrop.png b/static/img/Eballs/eyecrop.png new file mode 100644 index 0000000..41db840 Binary files /dev/null and b/static/img/Eballs/eyecrop.png differ diff --git a/static/img/Eballs/eyeselect.png b/static/img/Eballs/eyeselect.png new file mode 100644 index 0000000..05fcbfc Binary files /dev/null and b/static/img/Eballs/eyeselect.png differ