Skip to main content

MR Spatial Sync

The addonIcon.pngaddonIcon.pngSpatial Sync add-on for SimLab Composer allows you to perfectly align your virtual 3D environmentcontent with your real-world physical space. This is essential for Mixed Reality (MR) experiences, where a full virtual objectsinterior (like a new kitchen layout) needneeds to sit accurately within your actual room.room — or where a single virtual model (like a PC case) needs to sit exactly on your real desk.

Prerequisites

Before launching the add-on, organize the content you mustwant organizeto yoursee scene:

in


Mixed

Reality:

[!IMPORTANT]

Naming Convention:Grouping: All objects that you want to appear in Mixed Reality must be placed inside a single group. namedThe interiorgroup (writtencan inhave allany lowercase).name 

 

1. The Setup Wizard

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

  1. Alignment Mode: Choose what you want to align with your physical space:

    • Single Object — align one model to a real object.
    Room Scale — align a whole interior to your room.

    This choice decides which parts of the MR Component are kept, so it cannot be changed later in the wizard.

    Select Group: Choose the interiorgroup that contains the models you want to align in MR. Any group youname created.is accepted.

    Corner Alignment: A yellow sphere will appearappears at the scenecenter center.of Shiftthe scene, at the world origin (0, 0, 0). Move your 3D modelobjects so that one of its roomtheir corners alignssits withexactly on this sphere.

    [!IMPORTANT]

    Do not move the sphere. It is a fixed reference point at 0,0,0 — only the objects in the scene should be moved.

    Avatar Placement: Position the avatar at a natural starting point, such as the room's entrance.

    Rotation Guide: A gizmo appears with four planes, one facing each direction — two red and two green. Rotate the provided groupgizmo until the two green planes line upalign with your 3D objects. This is how the edges/wallsMR experience knows the correct rotation of yourthose virtualmodels. room.Both Theseplane servepairs asare purely visual markers forreferences; the usergreen inpair VR.is simply the one you match to your objects.

    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.Next.

    Setup Finished: A confirmation window lets you know the MR Component has been set up successfully. Close the wizard — your scene is now ready to be launched in Mixed Reality.

     

     

    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:scene.

    Your reference point depends on the alignment mode you chose in the wizard:

    Alignment Mode Reference point in MR Room Scale The yellow sphere at the center of the scene. Single Object A small directional gizmo replaces the sphere. It works exactly the same way, but is smaller and has pointed rectangular handles for each axis, for more accurate placement of small objects.

    [!IMPORTANT]

    Controls: In SimLab VR Viewer, the Trigger is used for grabbing, and the Grip is used for events and triggering actions.

    • Positioning: GrabUse the virtualTrigger to grab the sphere (or the directional gizmo) and place it at the exact physical corner of your real room — or on the real object — that you selectedchose during setup. Press the Grip button to set it.

    • Rotating: A rotation ringgizmo will appear. Grab and rotate it until the green planes on your screen perfectly overlap with your real physical walls (Room Scale), or match the orientation of the real object (Single Object).

    • Finalizing: Press Apply to bring the interior objects into view. If the alignment looks correct, click Confirm to save the position.

    Adjusting the alignment afterwards

    If the position or rotation ends up slightly off, there is no need to restart. While still inside the experience you can:

      Grab the sphere (or directional gizmo) again and adjust its position. Re-grab the rotation gizmo and adjust the rotation.

      Summary Table: Alignment Tools

      Tool Action in VR Purpose
      Yellow Sphere (Room Scale) Grab with Trigger & Placeplace at corner Sets the "Anchor Point" for the room.
      Directional Gizmo (Single Object)
      Grab with Trigger & place on the real object Same anchor role as the sphere, with per-axis handles for precise placement of small objects. Rotation RingGizmo Grab & Spin Matches the virtual orientation to the real walls.space. Green Planes Visual OverlayReference ActsThe aspair ayou guidealign towith ensureyour 90°models alignment./ real walls. Red Planes Visual Reference Mark the remaining two directions. Reference only — they have no function of their own. Confirm Button Click to Save Permanently locksLocks the virtual scene to your room.real space.

      Why use Spatial Sync?

      • Precision: Ensures virtual furniturefurniture, renovations, or renovationssingle products are viewed at the correct scale and position.

      Flexibility: Two alignment modes cover both a full room-scale interior and a single small object placed on a real surface.

      Ease of Use: Replaces complex manual coding with a simple "grab-and-place" mechanic.

      Persistence: Once confirmed, the virtual interiorcontent stays locked to the real world, allowingworld for a stable walkthrough.walkthrough — and can still be re-adjusted at any time without leaving the experience.


      Watch this tutorial to learn more