Introduction to Tilt Five and Unity

A Tilt Five system is composed of glasses, a special game board with a retroreflective surface, and a motion-tracked wand controller. The glasses project an image from each eye to the game board, which reflects back to the player’s eyes to achieve a stereoscopic effect. The glasses track their position relative to the game board, as well as the position of the wand.

To use this system with a Unity project, we provide a plugin to act as a bridge between the Tilt Five hardware and Unity.

Requirements

  • OS: Windows 10
  • Unity 2018.4 LTS and newer

Add the Tilt Five Unity Plugin to your Project

Add the custom package (first time)

If you’re upgrading from a previous Tilt Five Unity plugin package, please go to the Upgrading section below this one instead.

  1. If you haven’t already, now is the time to download our latest software, including the Unity plugin. Install the latest driver release and the latest SDK release.
  2. Within the SDK folder, navigate to the Setup subdirectory and follow the instructions within to set up your new Tilt Five hardware.
  3. In Unity, create or open a project.
  4. From the SDK folder (on Windows this is %PROGRAMFILES%\TiltFive\SDK\UnityPlugin\), import TiltFive-Plugin.unitypackage. You can do this in two ways, either (a) drag and drop the file into your Unity Project panel, or (b) from the Unity Assets menu, choose Import Package > Custom Package, then browse to and select the TiltFive-Unity-SDK.unitypackage file and click Open.
  5. In the Import Unity Package pane, click All to select all the items (they should be selected by default)

Upgrade from a previously installed plugin

If you have never added the Tilt Five Unity plugin to your project, refer to the previous section instead.

  1. Close Unity
  2. Navigate to the Unity project in the file explorer
  3. Delete Assets/Tilt Five/ and Assets/Tilt Five.meta
  4. Open the Unity project
  5. Go to Assets -> Import Package -> Custom Package…
  6. In the Import Package… file picker, navigate to the installed SDK path (on Windows this is %PROGRAMFILES%\TiltFive\SDK\UnityPlugin\), then select and open TiltFive-Plugin.unitypackage

If upgrading from 1.2.2 or earlier to 1.3.0+: please refer to Upgrading Unity Projects to SDK 1.3.0 for additional steps and tips for upgrading your project.

Create a Tilt Five Capable Scene

Now that you have imported the plugin, it’s time to display something on the glasses. There are three required components that must be present in a Tilt Five capable scene: a Game Board, a Camera to be controlled by the headset’s positional data, and a Tilt Five Manager. These instructions will give you the simplest Tilt Five capable scene with the tracking origin at [0.0, 0.0, 0.0].

  1. Create a new scene.
  2. Disable or delete the Main Camera GameObject.
  3. Add a cube to the scene at [0.0, 0.5, 0.0].
  4. In the Project window, under Assets > Tilt Five > Prefabs, drag the Tilt Five Prototype prefab into the Hierarchy, and ensure that its Transform component has a position of [0.0, 0.0, 0.0] and a rotation of [0.0, 0.0, 0.0].
  5. Press Play to run the scene in the editor.

Configure Settings

  • Enabling multisample antialiasing (MSAA) is recommended to smooth out sharp edges.
  • DirectX11 is required on Windows - OpenGL rendering is not yet supported.
Tags: