User Guide

CloudExpo 3D

Build immersive tours from Gaussian-Splat captures — walk through real-world spaces, drop interactive markers, place teleporters, draw a floor-plan minimap, and share a polished viewer link with anyone.

PART 1

Getting started

1.1

What is 3D mode?

3D mode lets you build tours inside real-world Gaussian-Splat captures instead of 360-degree photos.

CloudExpo started as a tour builder for 360-degree panoramas. 3D mode adds a second authoring path for Gaussian-Splat scenes — photoreal 3D captures of buildings, sites, products, or rooms. You walk through them just like a 3D viewer, and place the same kinds of interactive markers (images, videos, audio, text, links) that you'd use in a 360 tour.

In short: 3D mode = real-world 3D environments with markers, viewpoints, and a publishable viewer. Pick "3D Scene Project" when you create a new project.
1.2

Quick start

From an empty dashboard to a sharable 3D tour in seven steps.

  1. From the dashboard, click + Create a new Project and pick 3D Scene Project.
  2. Click Add Scenes in the bottom-left panel and pick a Gaussian-Splat file (.sog, .splat, or .ply) from your media library.
  3. Fly through the scene using the mouse (orbit, pan, zoom) or the W A S D Q E keys.
  4. Draw walkable boundaries so viewers stay inside the captured area.
  5. Drop markers — images, videos, audio, text, or viewpoints — anywhere in the scene.
  6. Click Set as starting screen to capture the camera angle every viewer will land on.
  7. Click Preview to test, then Publish to ship a sharable link.
Tip: You can start adding markers right away even without picking a Gaussian-Splat first — an empty scene will be created for you, and you can pick a background later.
1.3

Keyboard shortcuts

Everything in 3D mode is reachable from the UI, but these shortcuts save clicks while you're authoring.

KeyWhat it does
W A S DFly forward / left / back / right relative to the camera.
Q / EFly down / up.
TSwitch the gizmo to Translate (when something is selected).
RSwitch the gizmo to Rotate.
S (with selection)Switch the gizmo to Scale. Without a selection, S flies the camera backward instead.
EscDeselect.
Delete / BackspaceDelete the selected marker or boundary.
PART 2

Building your scene

2.1

Scenes & backgrounds

Each scene holds one 3D environment (the Gaussian-Splat capture) plus all the markers, boundaries, and viewpoints inside it. Projects can have many scenes.

Add a scene

Click Add Scenes in the bottom-left scene panel. Pick a Gaussian-Splat file from the media library — supported extensions are .sog, .splat, and .ply. The file becomes the scene's background and shows up as a thumbnail tile in the scene list.

Switch scenes

While editing, click any scene tile in the bottom-left panel to switch to it. In preview mode, switch via the scene-switcher dropdown at the top of the canvas.

Rename, duplicate, or delete a scene

Each scene tile has small action buttons on hover — pencil to rename, copy to duplicate, trash to delete.

2.2

Camera & movement

Move the camera with your mouse, with the keyboard, or both — they're always live at the same time.

Mouse / trackpad

Keyboard (first-person fly)

Use W A S D Q E to fly through the scene like a first-person game. The camera moves along its current viewing direction, so you can combine WSAD with mouse orbit to navigate naturally.

Heads up: When you're typing in a text field (like a marker description), the WSAD keys go to the text input — not the camera. Click away from the field to fly again.
2.3

Starting view

Set the camera angle every viewer lands on when they open the scene.

Fly to the camera pose you want viewers to see first, then click Set as starting screen (the house icon in the top toolbar). The current angle is saved with the scene. Every time someone loads the project — or switches to this scene from another — the camera lands here.

Tip: Choose a starting view that frames the most important content (a hero shot, the first marker the viewer should notice). Without a starting view, CloudExpo auto-frames the scene to fit the full capture, which sometimes lands far from the action.
2.4

Skybox

Wrap the void around your splat with a 360-degree backdrop image — sky, indoor lighting, gradient, anything.

A Gaussian-Splat captures a finite volume of space. Anything outside that volume is empty (rendered as black). The skybox fills that void with a 360-degree image so the scene feels complete.

How to set

  1. Click the Skybox button in the sidebar (only visible in 3D mode).
  2. Pick any equirectangular 360 image from the media library.
  3. The image wraps around the camera as the scene's background. Your splat renders in front of it.

The skybox is saved per scene — different scenes can use different backdrops.

2.5

Movement boundaries

Define the area where viewers are allowed to walk. Outside the boundary the camera glides along the wall instead of escaping.

Draw a boundary

  1. Click the Boundary button in the sidebar. A translucent cyan box drops at the camera's current position.
  2. Click the box to select it, then drag the gizmo handles to move, rotate, and resize it. You can make it any shape — narrow corridor, square room, sprawling outdoor area.
  3. Add more boundaries if your space has multiple walkable areas. The combined union of all boxes is the walkable region.
  4. Press Delete with a boundary selected to remove it.

What the viewer sees

Tip: Don't draw boundaries that are too tight — leave a little headroom so viewers don't feel trapped. A box that comfortably contains the capture plus a small buffer works well.
PART 3

Markers & navigation

3.1

Markers overview

Markers are interactive points placed inside the 3D space. Viewers click them to see images, play videos, jump to viewpoints, or open links.

How to add a marker

  1. Fly to where you want the marker to appear.
  2. Click one of the marker buttons in the right sidebar (Viewpoint, Image, Video, Audio, Text, Embedded, 3D Model).
  3. For media markers (Image, Video, Audio, 3D Model), the media library opens — pick a file.
  4. The marker appears a short distance in front of the camera. Drag the gizmo to fine-tune its position.

Marker types at a glance

Viewpoint

In-scene teleporter. Clicking it moves the camera to the marker's exact spot and facing direction.

Auto-named Viewpoint A, B, C…
Image

Click to open a lightbox with the image. Great for photo callouts, diagrams, signage.

Marker icon shows the image by default.
Video

Click to open an overlay player with controls — autoplays on open.

Supports any video the library accepts.
Audio

Plays in the background when clicked. No overlay — keeps the visual scene clean.

Optional autoplay-on-arrival, volume control.
Text

Renders the text directly in 3D space — like a sign hanging in the world.

Font, color, bold all customizable.
Embedded

Click to open any URL in an overlay iframe. Maps, dashboards, web apps.

Type the URL into the marker panel.
3D Model

Place a glTF model (.glb) or a smaller Gaussian-Splat as actual 3D geometry in the scene.

Becomes permanent décor, not a clickable icon.
3.2

Viewpoint teleporters

Save specific camera spots so viewers can jump to them instantly. Perfect for guided tours and bookmarked angles.

Create a viewpoint

  1. Fly to the position and angle you want to save.
  2. Click the Viewpoint button in the sidebar. A marker appears in front of the camera with an orange arrow showing the direction it'll face when activated.
  3. Each viewpoint is auto-named Viewpoint A, then B, C… Rename it in the marker panel if you like.

What viewers see

In preview, clicking the viewpoint marker teleports the camera to the marker's exact position and facing direction. The orange arrow only shows in the editor — viewers see only the icon, not the arrow.

Tip: Combine viewpoints with the minimap for a powerful navigation experience — viewers see all the viewpoints on a 2D floor plan and click to teleport, instead of having to fly there.
3.3

Image markers

A clickable spot that opens a full-screen image when the viewer clicks it.

Image markers are perfect for product photos, diagrams, signage callouts, or before/after images. The marker's icon defaults to the image itself, so viewers see a thumbnail in 3D space — they get a visual hint of what they'll see when they click. (You can override the icon — see Customizing.)

Add via the Image sidebar button → pick an image from the media library.

3.4

Video markers

A clickable spot that opens an overlay video player.

The video starts playing automatically when the viewer clicks the marker. Standard controls (play / pause / seek / fullscreen) are available. Close the overlay to return to the 3D scene.

Add via the Video sidebar button → pick a video file from the media library.

3.5

Audio markers

Place audio cues anywhere in the scene. Play on click, or have them autoplay when the viewer arrives.

Add an audio marker

Click the Audio sidebar button and pick an audio file. The marker appears as a small speaker icon — no overlay or player UI, the audio just plays in the background when clicked.

Audio options

Browser note: Some browsers block autoplay until the viewer has interacted with the page at least once. If the audio doesn't start, the viewer clicking anywhere usually unlocks it.
3.6

Text markers

A label that appears directly in 3D space — like a sign hanging in the world. No click required, the text is always visible.

Add a text marker

  1. Click the Text sidebar button.
  2. A small text panel appears in front of the camera, facing you.
  3. Open the marker panel (click the text) and type your content in the Text field. Multiple lines are supported.

Styling

Text markers are spatial — they stay flat in the world wherever you place them, viewed from any angle. Rotate them with the gizmo to stick text on a wall or floor.

3.7

Embedded markers

Open any external web content — a Google Doc, a map, a dashboard, a form — in an overlay when the viewer clicks.

Embedded markers carry a URL instead of a media file. Add via the Embedded sidebar button, then type the URL into the Embed URL field in the marker panel. When a viewer clicks the marker, the URL loads in a full-screen iframe overlay.

Cross-origin note: Some sites (like Google, YouTube logged-in pages) prevent themselves from being embedded with a security header. If the iframe shows blank or an error, the target site doesn't allow embedding — use a link in a Text marker instead, or pick an embeddable alternative.
3.8

3D Model markers

Place a glTF model or a smaller Gaussian-Splat as actual 3D geometry in the scene — it becomes part of the world.

Unlike other marker types (which place a small icon you click), a 3D Model marker places the actual model in 3D space — it's permanent décor. Use it to drop product mockups, furniture, signage, or pre-rendered objects into your captured environment.

Add a 3D Model

  1. Click the 3D Model button in the sidebar.
  2. A small dialog asks: glTF / glb or Gaussian Splat? Pick the file type you have.
  3. The media library opens filtered to that file type. Pick your file.
  4. The model appears in front of the camera at default scale. Drag the gizmo to position, rotate, and resize.

Supported formats

3D Models don't show a clickable icon — they're decorative. They don't open an overlay when clicked.

3.9

Customizing a marker

The right-side marker panel lets you change every aspect of a selected marker — content, icon, size, visibility, description.

The marker panel

Click any marker in the editor to open the marker panel. Different marker types show different controls, but most include:

PART 4

Editing

4.1

Move, rotate, resize

Every selected object — marker, boundary, or the Gaussian-Splat itself — gets a gizmo with handles for translate, rotate, and scale.

The gizmo

Click any marker (or the splat, or a boundary) to select it. A coloured arrow / ring / box appears at its origin:

What you can select

Tip: The gizmo arrows align with the object's own axes, not world axes. So if you rotate a marker first, then scale it, the scale handles will pull along the marker's new orientation — much more intuitive than world-aligned axes.
4.2

Layers panel

A list of every marker in the current scene. Click to select, double-click to fly to, trash to delete.

PART 5

The viewer experience

5.1

Preview mode

Switch the editor into viewer mode to test exactly what your audience will see.

Click Preview in the top toolbar to enter preview mode. The editor chrome (sidebars, scene list, gizmos) hides. The 3D canvas takes over the screen, and markers become clickable triggers instead of editable items:

Click Return to Edit Mode to come back to the editor.

5.2

Scene switcher

A dropdown at the top of the viewer that lists every scene in your project. Click to jump.

The dropdown shows the active scene name with a small chevron. Click to open the full list; click any scene to switch. Long scene names are truncated in the pill but shown in full in the menu. Click anywhere outside the dropdown to close it without switching.

5.3

Minimap

A 2D floor-plan overlay with clickable dots for each viewpoint. Click a dot to teleport.

Set up the minimap (editor)

  1. Click the Minimap button in the top toolbar (the building / floor-plan icon).
  2. Click Change Background and pick any image from the library as the floor plan.
  3. Click Add Point to drop a blue dot. Drag the dot to position it on the floor plan.
  4. Click the dot to open the popover, then pick which viewpoint it links to from the dropdown.
  5. Click Save.

What viewers see

In preview, a small minimap panel appears at the top-right. Each dot you authored is clickable — the viewer clicks it and the camera teleports to the linked viewpoint. The panel can be folded with the small icon in the header — clicking it collapses the panel to a compact pill so it doesn't crowd the view; clicking again expands it.

Tip: The minimap is per scene — each scene can have its own floor plan and its own viewpoint dots. Switching scenes loads a different minimap automatically.
5.4

Magic reveal animation

Every time a Gaussian-Splat scene loads, a glowing wave sweeps across the capture as it materializes — like the scene is being conjured in front of you.

It happens automatically whenever a 3D scene loads or you switch between scenes. The effect lasts about 4.5 seconds:

It's purely visual — no setup required. It just runs.

PART 6

Sharing

6.1

Save & publish

Save while you work; publish to give your tour a public URL.

Save

Click Save in the top toolbar to save a draft. Drafts are visible only to you. The button shows a toast confirmation when the save completes; you can close the tab and come back to the project from the dashboard at any time.

Publish

Click Publish when you're ready to share. A unique shareable URL is generated — anyone with the link can open your tour without needing a CloudExpo account. Re-publishing updates the same URL, so you can share it once and keep iterating.

That's it. You've built a 3D tour. Share the published link with your audience, embed it in a website, or send it in an email. Same tour, every device.