1. What is VR Toolbox?

VR Toolbox is an experiment on creativity and functionality in VR, with a vision to be a virtual room simulator. This allows anyone to create the room of their dreams, with pre-made props and “technology posters” allowing users to decorate their rooms to their liking. For example, VR Toolbox users could build a cozy and intimate environment, an enchanted forest, or a futuristic spaceship-style room. Part of a dream room is allowing infinite TVs and monitors, which is supported through VR Toolbox’s functionality allowing users to create as many web apps as they like, whether that means watching YouTube videos and playing a video game or Skyping with friends.

MyDream has pioneered the concept of enabling the forward-facing camera on the VR headset for users to see their keyboard, grab a drink off the desk, or engage with people around them without the need to remove the VR headset. The camera is blended with the virtual world and is activated based on a set of configurable gestures, such as the user looking down at the keyboard. This “blended reality” allows for ease of typing and maintaining awareness of the physical world.

The product is geared towards everyone from the casual VR user to those who want a fully-immersive VR experience with their headset on throughout. VR Toolbox offers quality graphics which are realistically lit by the screen, and props which personalize the VR space. Window orientation, backgrounds, and additional features can also be customized and automatically saved so when you exit and restart the application, it restores the same VR state.

2. Oculus Setup

2a - Pre-Installation Checklist
- You must use the current version of the Oculus Home software. Older runtime versions like 0.8 are not supported.
- Enable Unknown Sources in the Oculus Store by opening the Oculus Home Settings menu, navigating to the General tab, and toggling on "Unknown Sources" at the top of the list.
- Make sure SteamVR is turned off to maintain optimal performance and to avoid conflicts with Steam Desktop Theater.

3. Vive Setup

3a -  Pre-Installation Checklist
- Enable SteamVR in the Steam desktop client.
- Disable Steam Desktop Theater as it conflicts with games running alongside VR Toolbox. In Steam, go to Steam settings and uncheck the Desktop Theater box in "The Steam Overlay" section.
- Make sure the main devices are green lit and are running and recognized.
3b - Vive Pass-Through Camera
The Vive camera must be enabled for Camera Pass-Through to work, which is done by opening the Settings in SteamVR, then accessing the Camera tab and adjusting the settings to Enable Camera and Allow Camera for Room View. On some systems, the refresh rate needs to be reduced for proper operation.
Sometimes the Vive camera hangs, which requires rebooting the headset to fix. To do this, right click on the green HMD icon in SteamVR and then click on Reboot. If this does not fix the issue, close SteamVR, unplug the USB cable connected to the Link Box from the computer, then plug it back into the computer and start SteamVR again.

4. Navigating the VR Toolbox UI

This section covers the general operation of VR Toolbox.

4a - VR Toolbox Menu Features

Video Options tab covers the following features:
- Over-Sample Amount (Improves Clarity)
- 4x Super-Sample Anti-Aliasing (Uses GPU to smooth out rough edges)
- Enable Beer Mode (Camera Pass-Through allows Vive users to look down to peer through the VR scene to locate their desk contents, such as an input device or beverage)
 - Activate When Looking Behind (Allows the camera to engage when looking away from a forward position, to look around the room without removing the headset)
- Toggle Angle slider (increase or decrease the angle at which the camera engages, if it is enabled)

Settings tab covers the following features:
- Show the Mouse Pointer (Toggle on/off display of the mouse pointer when using the Vive controller)
- Enable First Person Mode (Primary display becomes a fixed screen, and head motion translates as an additional mouse input)
- Mouse Mapping Sensitivity Slider (Adjust the amount by which the mouse is moved by head rotation)
- 3D Movie Mode (Select one of multiple methods to overlay side-by-side or top-bottom stereoscopic display on the primary display.)

Backgrounds/Props tab covers the following features:
- Background Drop-Down Menu (Select one of the 2d or 3d environments to fill the scene, or turn them off for a more empty space)
- Enable Allow Rotation of the 360 Backgrounds (Enable to use the controller to grab and adjust the background with the controller, which also disables adding props and screens)
- Snap Screens and Props to the Vertical Axis (This causes objects and screens within a few degrees of an upright orientation to snap upright when the position/orientation is being adjusted)
- Upload Button (Upload a 3D prop to the VR Toolbox Steam Workshop page. Refer to the Steam Workshop Guidelines section for more information)

Misc tab covers the following features:
- Recenter (Horizontally reorients the facing direction of the scene to where the headset is pointed)
- Guide (Launches the vr-toolbox.com/guide page in the default browser)
- Hotkeys (Brings up images for Controller and Keyboard hotkeys)
- Steam (Opens the VR Toolboxstore page in Steam)
- Defaults (Restore the default settings for VR Toolbox, but does not remove anything from the scene)
- Delete User (Delete cache and cookies for the VR Toolbox browser, along with session settings)

5. Operating VR Toolbox

General Use

There are a few main components to VR Toolbox use and operation. First is the VR Toolbox Global Settings window, which controls many of the functions and settings for VR Toolbox. It looks like this, and should be located on one of your Desktop screens.

The second is the VR Toolbox environment itself. The background can either be set to blank, or can have a skybox image used to ground the user and provide them with the context of an environment. Aside from the background, everything you see in VR Toolbox is an object - desktop screens, browser screens, webcam screen, and all of the decorative props, are virtual objects that can be positioned, rotated, and scaled to your liking.

The third is the Virtual Controller, which is a virtual representation of your real-world motion controller. The ray pointing from the controller shows where it is aiming, which is used to target objects to manipulate them, or to interface with the desktop and browser screens with mouse-like inputs. Left Click and Right Click are accessed by pushing in the Left and Right sides of the Vive controller touchpad, or the ABXY buttons on the Oculus Touch.

Reposition an Object (Prop or Screen)

Aim at the object and hold the Trigger button to engage reposition mode:
- Aiming around the environment moves the position.
- Twisting the controller Left and Right changes the clockwise rotation.
- Swipe the Vive touchpad up and down or tilt the Touch analog stick forward and back to adjust the distance.
- Swipe the Vive touchpad left and right or tilt the Touch analog stick left and right to adjust the horizontal rotation.
- Press in the Vive touchpad towards the top or bottom or ABXY buttons to increase or decrease the scale.

Freely Rotate an Object (Prop or Screen)

Aim at the object and hold the Side Grip button to engage free rotation mode:
- Aiming Up and Down adjusts the top-bottom rotation.
- Aiming Left and Right changes the horizontal rotation.
- Twisting the controller Left and Right changes the clockwise rotation.
- Press in the Vive touchpad towards the top or bottom or ABXY buttons to increase or decrease the scale.

Access the Prop Menu

Aim at an object and press the Menu button or push in the Analog stick to open the menu.

For Screens and Browsers, the menu appears on the screen itself, and is closed the same way it  is opened.

For all other objects, a radial menu appears, offering a variety of features:Locked toggles the ability to manipulate the object.Link allows the object to be positionally tethered to another object so they move together.Alt Skin cycles through available skins and textures for the object.Duplicate creates a copy of the prop with the exact same properties. Delete removes the prop from the environment.

Open The Radial Menu

HTC Vive - Press the Menu button twice rapidly
Oculus Touch - Push in the Analog stick twice rapidly
This menu appears around the controllers, so you will either need to look down at the controller to access it, or you will need to bring the controller up to your line of sight.

Create a new Browser or Webcam Screen

Open the Radial menu, then access the Screens option at the top using the touchpad or analog stick.

For an additional 1920x1200 Chromium-based Browser screen, select the Browser icon, aim in space, and press the Trigger button to place it. You may add as many of these as you want.

For an additional webcam screen, use the Webcam icon, aim in space, and press the Trigger button to place it. To change the webcam input source, aim at the screen, press the menu button or push in the analog stick, select Advanced, and select “Choose Webcam Source” to cycle through attached webcam devices.

Place New Props and Furniture

Open the Radial menu, then access the Props option on the right using the touchpad or analog stick.

Props are divided into various categories for easier navigation. After a category has been selected, props will appear in on the ring selector surrounding the controller.

Swipe or move the analog stick left and right to select different props on the ring selector, then aim and press the trigger to place them in the environment.

Open the Controller Options Menu

Open the Radial menu, then access the Options option on the left using the touchpad or analog stick.
This menu can be used to Toggle On/Off the following features:
- Draw Mouse
- Rotate Background
- Ambient Occlusion
- Prop Snap to Y Alignment

Additionally, the menu can be used to take a screenshot of the scene, and to recenter the scene to the horizontal orientation of the headset.

5. Hotkeys & Controller Operations

Keyboard Hotkeys:
F1 = Toggle Mouse Visibility
F2 = Recenter Screen
F3 = Change 3D Mode
F8 = Screenshot of VR Scene (file goes to C:\Users\[User Name]\Documents\My Games\VRToolbox\screenshots)
Ctrl+Shift+Spacebar = FPS Mode
Ctrl+Shift+Numpad Plus/Minus = Increase and Decrease Screen Size

6. Steam Workshop Guidelines

Props in VR Toolbox must be in .obj format. Below are the guidelines for adding a prop:
- Diffuse texture
- Normal texture
- Preview image (for Steam workshop)
- obj file with normals, tangents and bitangents.
- mtl materials file
Regarding size, the screen is about 5 units, so scale props according to that.

Support for adding new background is coming later on!

7. Troubleshooting

We are still working on this section.