Alignment in Hololight Stream

Objectives

  • Be able to use alignment features to create a more immersive experience with Hololight Stream.

Prerequisites

  • Hololight Stream-supported device with Hololight Stream installed.

Alignment

Alignment in Hololight Stream allows users to adjust settings to better align the Hololight Stream experience with the real-world environment.

Alignment on most XR devices

The following instructions apply to the following XR devices:

  • HTC VIVE devices

  • Meta Quest devices

  • Microsoft HoloLens 2

  • PICO 4 Ultra

Origin

The origin is the point around which the entire space is positioned.

Set origin

  1. Open Hololight Stream on your device.

  2. Select Alignment.

    Screenshot from the Microsoft HoloLens 2 version of Hololight Stream

    hololight stream device microsoft hololens 2 alignment

  3. Select Set to reposition the origin.

  4. Follow the instructions that appear to place the origin.

    Screenshot of the origin

    hololight stream device android alignment gizmo

Meta Quest devices can fail to set the origin. This is sometimes caused by an issue with the Meta Quest’s own boundary system. You can fix this by clearing the physical space history on the Meta Quest. For more information on how to do this, check out Set up your boundary for Meta Quest and follow the instructions under Manage scene and physical space history > To clear your physical space history.
Delete origin

  1. Open Hololight Stream on your device.

  2. Select Alignment.

  3. Select Delete to remove the origin.

Spatial tracking

Spatial tracking captures the real-world surfaces around the device. The data from this scan of the environment helps the device find the floor along with other spatial data. XR devices like PICO 4 Ultra, the HTC VIVE devices, and the Meta Quest devices require spatial tracking to be enabled in order to set the Origin.

Spatial tracking differs between XR devices. This is because the capturing of real-world surfaces is handled by each device on the operating system level.
Enable spatial tracking

  1. Open Hololight Stream on your device.

  2. Select Alignment.

    Screenshot from the Meta Quest version of Hololight Stream

    hololight stream device meta quest and pico alignment

  3. Select Update to start spatial tracking.

Tracking automatically starts when setting an origin and there aren’t any spatial entities saved.

Some HTC devices require updating the spatial entities on the device itself.
On supported HTC devices, open the System Dashboard, then select Settings > Boundary > Mixed reality > Set up.
hololight stream device htc vive alignment
Meta Quest devices can fail to set the origin when using spatial tracking. This is caused by the device not having an accurate floor height. To fix the floor height on the device, redraw the boundary. For more information, check out Set up your boundary for Meta Quest and follow the instructions under Adjust your boundary.

Alignment on Apple iOS and iPadOS

  1. Open Hololight Stream.

    hololight stream device apple ios connect

  2. Select Settings > Calibrate Scene Origin..

    hololight stream device apple ios settings

  3. Follow the instructions to place the origin. When you are satisfied with the position, select Done.

    If you are having trouble finding the origin, select Reset.

    hololight stream device apple ios alignment place origin 00

    hololight stream device apple ios alignment place origin 01

Alignment on Apple Vision Pro

There are two ways to align the origin in Hololight Stream on Apple Vision Pro, either manual alignment or image tracking alignment. You can choose between them

Manual alignment on Apple Vision Pro

  1. Open Hololight Stream.

  2. Select the Alignment > Alignment mode > Manual.

  3. Select Start alignment.

  4. Follow the instructions to move and rotate the origin to place it in the space. If you are unable to find the origin, select Reset.

  5. When you are finished, select Done.

Image tracking alignment on Apple Vision Pro

You can use image tracking to align the origin. Check out Image tracking alignment in Hololight Stream.