MR Spatial Sync

The Spatial Sync add-on for SimLab Composer allows you to perfectly align your virtual 3D environment with your real-world physical space. This is essential for Mixed Reality (MR) experiences, where virtual objects (like a new kitchen layout) need to sit accurately within your actual room.

Prerequisites

Before launching the add-on, you must organize your scene:

[!IMPORTANT]

Naming Convention: All objects that you want to appear in Mixed Reality must be placed inside a single group named interior (written in all lowercase).

1. The Setup Wizard

Open the Add-ons menu, navigate to the MR tab, and launch Spatial Sync. The wizard will guide you through these steps:

Select Group: Choose the interior group you created.
Corner Alignment: A yellow sphere will appear at the scene center. Shift your 3D model so that one of its room corners aligns with this sphere.
Avatar Placement: Position the avatar at a natural starting point, such as the room's entrance.
Rotation Guide: Rotate the provided group until the two green planes line up with the edges/walls of your virtual room. These serve as visual markers for the user in VR.
Filter Non-MR Objects: Select any objects that should not be visible in Mixed Reality (e.g., placeholder walls, structural guides, or background environments) and click Next.

2. Real-World Alignment (In VR/MR)

Once you launch the experience on your headset in Mixed Reality mode, follow these steps to sync the scene:

Positioning: Grab the virtual sphere and place it at the exact physical corner of your real room that you selected during setup. Press the Grip button to set it.
Rotating: A rotation ring will appear. Grab and rotate it until the green planes on your screen perfectly overlap with your real physical walls.
Finalizing: Press Apply to bring the interior objects into view. If the alignment looks correct, click Confirm to save the position.

Summary Table: Alignment Tools

Tool	Action in VR	Purpose
Yellow Sphere	Grab & Place at corner	Sets the "Anchor Point" for the room.
Rotation Ring	Grab & Spin	Matches virtual orientation to real walls.
Green Planes	Visual Overlay	Acts as a guide to ensure 90° alignment.
Confirm Button	Click to Save	Permanently locks the virtual scene to your room.

Why use Spatial Sync?

Precision: Ensures virtual furniture or renovations are viewed at the correct scale and position.
Ease of Use: Replaces complex manual coding with a simple "grab-and-place" mechanic.
Persistence: Once confirmed, the virtual interior stays locked to the real world, allowing for a stable walkthrough.

Watch this tutorial to learn more