Skip to content

Navigating the Twin

The RealityTwin allows you to explore your space with multiple navigation modes.


Located in the top-left corner of the screen, the Navigation Menu gives you access to various navigation modes:

  • Fly

  • Third person

  • Photosphere

  • Home

This is the default state that allows you to use the tools and all the features of the application.

You may navigate in the environment using the navigation circle that appears under your mouse. To teleport somewhere, simply mouse click on the spot of the environment you want to teleport to. You may also rotate the view by holding and dragging the mouse cursor.

ActionInput
Teleport (mouse left double-click)
Rotate the view Hold and move mouse (mouse left-click)
Rotate around pivot Hold and move mouse (mouse right-click)
Move/panning Hold and move mouse (mouse middle click)
Zoom in/out (mouse scroll)
Move or
Move faster
Move up
Move down

Third Person Navigation allows you to explore the environment using your avatar as a visual reference within the 3D space. Instead of navigating from a first-person perspective, the camera follows your avatar from behind.

You can activate Third Person mode from the Navigation Menu located in the top-left corner of the screen.

ActionInput
Walk towards (mouse left double-click)
Rotate the view Hold and move mouse (mouse left-click)
Zoom in/out (mouse scroll)
Move or
Move faster
Jump
Crouch

Photosphere Navigation allows you to explore the site through high-resolution 360° imagery captured by scanners. It’s ideal for inspection, review, and providing realistic visual context tied to specific capture stations.

Photospheres are not just static images, they fully support:

  • RealityAsset & 3D objects overlays

  • Measurements for quick verification

  • Annotations to document and share insights

These elements blend directly into the imagery, creating a rich and realistic environment that feels immersive and interactive.

Movement in Photosphere mode is limited to scanner station positions. You can jump between them by selecting visible hotspots or station markers.

ActionInput
Jump to another station (mouse left-click)
Rotate view Hold and move mouse (mouse left-click)

The Minimap in RealityTwin is a spatial awareness tool located in the lower-left corner of the interface. It provides a real-time top-down view of your Twin, helping you maintain orientation and better understand your position within the larger environment.

You can toggle the minimap’s visibility from the View Menu:

  1. Open the View Menu (located at the top right of the interface).

  2. Enable or disable the Minimap based on your preference.

A Twin or Plan often combines several datasets, and each dataset can include more than one visual representation of the same data — for example a Mesh, a Point Cloud, or a Gaussian splat. Rather than displaying every representation at once, a priority order decides which one to show for each dataset.

  • Representations follow a ranked priority order. The default is Mesh > Point Cloud > Gaussian splat.

  • Every dataset in the scene is displayed at the same time, each using the highest-priority representation it actually has.

  • If a dataset does not have the top-priority representation, it automatically falls back to the next available one in the order — for that dataset only.

Example: with a priority of Mesh > Point Cloud, you load two datasets together. Dataset A has both a mesh and a point cloud; Dataset B has only a point cloud. The viewer shows Dataset A as a mesh (its highest available representation) and Dataset B as a point cloud (it has no mesh, so it falls back) — and both render together in the same scene.

You can change the priority order from the Views panel:

  • Drag and drop a representation up or down to raise or lower its rank, or

  • Open the overflow menu (⋮) on a representation and select Move up or Move down.

The order applies to all datasets in the current Twin or Plan — each one updates to display the highest-priority representation it has available.

CAD and Photosphere layers operate as binary overlays that can be toggled On or Off independently. They are not part of the representation priority system and are not affected by the priority order.

RealityTwin adjusts how the scene is rendered based on your hardware so navigation stays smooth while preserving visual quality where your machine allows.

When you open a Twin, RealityTwin automatically detects your hardware and selects the quality mode that best balances responsiveness and visual quality. You can override this choice at any time — see Manual modes below.

You can also set the rendering quality yourself from the View → Quality menu:

  • Performance — lightweight rendering that favors responsiveness. A Recommended chip marks the mode that best fits your current hardware.

  • High fidelity — higher visual quality for more capable hardware.

  • Ultra high fidelity — maximum visual quality for high-end, GPU-accelerated machines.

  • Reset to recommended — return to the mode RealityTwin suggests for your setup.