Viewpoint
The Viewpoint module is used to preset key observation points and automatic roaming paths in the scene. It supports three types: Tour / Roaming / Area Viewpoint.
Note: Viewpoint data in the current version is not compatible with older versions. If you open a project containing legacy viewpoint data, the system will prompt that the data cannot be read and needs to be recreated.

Viewpoint module
Entering Viewpoint Editing
Click the "Viewpoint" icon in the left toolbar to open the bottom sidebar. The top of the sidebar provides three tabs: "Tour," "Roaming," and "Area Viewpoint."
Tour
Used to preset multiple observation points in the scene. In Preview Mode, click to quickly jump to the preset view angle.

Tour
Creating Tour Points
- Switch to the "Tour" tab
- Adjust the camera to the desired position and orientation
- Click the "Add Point" button
- Set parameters in the Property panel
Tour Point Properties
| Property | Description |
|---|---|
| Point Name | Required, ≤50 characters |
| Introduction Title | Optional, ≤50 characters |
| Introduction Text | Optional, ≤300 characters |
| Camera Movement | Static (default) / Left to Right / Right to Left |
| Camera Angle | 0°–360° |
| Position Coordinates | x, y, z |
| Lock Point | Locked points are not affected by "Apply settings to all tour points" |
- Click "Apply this point's settings to all tour points" to batch-apply the current settings to all unlocked tour points
Tour in Preview Mode
- Markers in the space represent tour viewpoints
- Hover to display the title
- Click to move the camera to that viewpoint
Roaming
Used to draw continuous touring paths and generate automatic roaming animations.

Roaming
Route Management
- A vertical list displays all roaming routes
- Click the "New Route" button at the top to create one (up to 10 routes)
- A delete button appears on hover at the right side of each route (requires confirmation)
Route Properties
After selecting a route, the Property panel displays:
| Property | Description |
|---|---|
| Route Name | ≤50 characters |
Drawing Roaming Paths
- Select a route
- Manually adjust the camera to the desired position and orientation
- Click "Add Point" to save the current view as a path point (the system automatically captures a thumbnail)
- Repeat steps 2–3 to add more points
- New points are automatically appended to the end of the route, with smooth connecting lines to the previous point
Point List
- A horizontal scrolling thumbnail list is displayed at the bottom of the sidebar
- Click a thumbnail: Camera flies to that point's view angle
- Long-press and drag: Change point order
- Delete button appears at the top-right on hover
Roaming Point Properties

Roaming point properties
| Category | Property | Description |
|---|---|---|
| Basic Info | Point Name | ≤50 characters, required |
| Introduction | Title | Optional, ≤50 characters |
| Introduction | Introduction Text | Optional, ≤300 characters |
| Roaming Settings | Dwell Duration | Numeric input (seconds), minimum 0.1, default 3 |
| Roaming Settings | Transition Duration | Transition time from this point to the next |
| Roaming Settings | Transition Mode | Linear (smooth movement) / Teleport (instant switch) |
| Camera Settings | Camera Movement | Static / Left to Right / Right to Left |
| Camera Settings | Camera Angle | 0°–360° |
| — | Lock Point | Locked points are not affected by batch apply |
Keyboard Shortcuts:
| Shortcut | Function |
|---|---|
Space | Play from current cursor position / Pause |
→ (Right arrow) | Jump to next shot start position |
← (Left arrow) | Jump to previous shot start position |
Playback Controls:
- Play / Pause / Stop button group
- Total duration label
Render Video
After selecting a route, you can export the roaming path as a video file.

Render video
| Parameter | Options |
|---|---|
| Resolution | 1080p / 2K / 4K |
| Frame Rate | 30 / 60 FPS |
| Export Format | MP4 |
| Encoding | H.264 / H.265 |
| Storage Location | Local folder / Media Render group |
| Mode | Gaussian mode / Point Cloud mode |
Note: The render button is greyed out when no points have been added to the route.
Roaming in Preview Mode
- Roaming path auto-plays upon entering Preview Mode (if available)
- Pause: Click the pause button
- Resume from breakpoint: After pausing, click play to continue from the point nearest to the user
- Loop playback: After the last viewpoint, playback automatically restarts from the beginning
Note: Roaming playback and annotation features are mutually exclusive — annotation-related features are automatically disabled during playback.
Area Viewpoint
Used to record a positioned view with a defined viewing range. Can serve as a screenshot source for Scene Reports.
Area Viewpoint Properties
| Property | Description |
|---|---|
| Title | ≤50 characters |
| Position Coordinates | x, y, z |
| Area Length/Width | Numeric stepper |
| Area | Read-only, auto-calculated |