Link

This site uses Just the Docs, a documentation theme for Jekyll.

Search

Learn how the Litho demo scene works

Litho beta release 0.6.1 (2020-05-14)

Table of contents

  1. Video tutorial
  2. Instructions for using Litho in the Unity Editor

Video tutorial

Instructions for using Litho in the Unity Editor

For more detailed information about the Litho showcase scene, see here.

  1. Open the showcase scene (/Packages/Litho Beta SDK/Demo/LithoShowcase/LithoShowcase.unity)

    Due to a bug in early versions of Unity 2019.3, you may need to use Right-click -> Open Scene Additive, followed by closing whichever scene was already open using Right-click -> Remove Scene

  2. Press Play to run the scene (the Play button should remain depressed and glow blue)

  3. Move your mouse over the Game view to begin interacting with the scene using the Litho Emulator - use left-click (and hold) to interact using Litho; use right-click and drag (with W, A, S, D keys) to move the camera around

  4. Open the Litho dropdown menu by clicking the hamburger icon in the top-right corner of the Game view - this is where you can connect to Litho on Mac and mobile devices only - if connecting on Windows, see the pairing instructions here.

  5. If using Unity on Mac, wait for your Litho device name to appear on the list in the Game view. Ensure Bluetooth is enabled on your computer and that your Litho device is charged. This may take a short while the first time you run the scene

  6. In the Game view, connect to your Litho device by clicking its corresponding “Connect” button - the button will update to say it is “Connecting…” - wait briefly while the connection is established

  7. Calibrate your Litho with the Unity Editor:

    Calibrate in Game view:

    1. Swipe through the Litho dropdown menu to the Litho device details tab (look for a picture of a Litho at the top)
    2. Make sure you are wearing Litho in the correct grip (configured by your app on the device details screen; default is Point grip)
    3. Point in an arbitrary direction (e.g. towards your screen) to use as ‘forwards’ whilst testing your app
    4. Click the Calibrate Litho button

    Calibrate using the Unity menu:

    Calibrate using the LITHO menu

    1. Make sure you are wearing Litho in the correct grip (configured by your app; default is Point grip)
    2. Point in an arbitrary direction (e.g. towards your screen) to use as ‘forwards’ whilst testing your app
    3. In the Unity Editor menu bar press LITHO -> Calibrate

  8. You should now be able to see the laser pointer protruding from the Litho object, which should be tracking your real-world Litho position and orientation relative to the ARCamera object

  9. By pointing at the cube in the game world, and touching and holding the touchpad on the bottom of your Litho, you should be able to manipulate the cube in 3D space. Whilst holding in Point grip, twist your wrist left and right to move the cube along the axis of the pointer

  10. When finished, click the Play button again to stop the scene (the Play button should return to its unpressed state)