Scene Builder UI Guide

Use this guide for the Scene Builder experience at route:

• /asset-visualizer

Purpose

Scene Builder is the main UI for assembling and iterating environment + asset + camera + trajectory state before running downstream preview/export/SITL workflows.

Main Regions

1. Viewer pane: live 3D scene preview and selection interactions.
2. Inputs pane: editable controls and pane sections for assets, cameras, terrain/space, trajectories, and artifacts.
3. Mode controls: layout and annotation mode selection (classifier, vla, sitl) in preview layout.

First-Run Workflow

1. Open /asset-visualizer.
2. Verify you are in preview mode and the viewer is rendering.
3. Configure foundational scene context first (terrain/space preset + defaults).
4. Add assets/cameras and confirm transforms in viewer.
5. Save artifacts/checkpoints once the scene state is stable.

Editing Checklist (UI Changes)

• Keep viewer interactions responsive while inputs update.
• Confirm selection state is preserved when switching panes.
• Validate route-level load does not regress (/asset-visualizer opens without runtime errors).
• For camera/trajectory changes, verify step/playback controls still update viewer state.

Common Issues

UI updates not reflected in viewer

• Check whether change landed in draft state only vs committed state.
• Confirm any "save/commit" handlers fire on blur/enter if required by that control.

Scene state appears reset unexpectedly

• Verify whether clear/reset handlers were triggered by mode switch or import/export flows.
• Re-check active preset/artifact selection and loaded checkpoint version.

SITL mode not matching preview mode

• Confirm annotation mode toggle is set to sitl.
• Verify trajectory step/max-step data is present in the active inputs bundle.

Related Pages

• Getting Started
• Server Guide
• Package Reference