Viewpoints

A Viewpoint saves a camera position, orientation, and optionally the current visualisation settings. Double-clicking a viewpoint in the Scene Explorer or clicking it in the scene restores the saved camera state.

Creating a Viewpoint

ToolDescription
Save Current CameraSaves the current camera position and orientation.
Save Current Camera with Visualisation SettingsSaves the camera as above, plus all current visualisation settings (colour mode, skybox, post-processing, etc.).

Ribbon Settings

Transform

  • Heading — Camera heading angle in degrees.
  • Pitch — Camera pitch angle in degrees.

Camera Override

Settings here let the viewpoint override global camera behaviour when it is activated:

  • Override Camera Speed — If enabled, activating this viewpoint sets the camera movement speed to the specified value.
  • Speed — Camera movement speed (metres/second) to apply on activation.
  • Override Lock Altitude — If enabled, activating this viewpoint sets the altitude lock state.
  • Lock Altitude — Whether altitude is locked when this viewpoint is activated.

Bounding Sphere

Defines an optional bounding sphere visualisation centred on the viewpoint:

  • Enabled — Show the bounding sphere in the scene.
  • Preview Enabled — Show a preview of the sphere while editing.
  • Pick Sphere — Click in the scene to define the sphere interactively.
  • Position X / Y / Z — Centre of the bounding sphere.
  • Radius — Radius of the bounding sphere in metres.

XR (Extended Reality)

When XR/stereoscopic display is active:

  • Position X / Y / Z — Placement position in XR space.
  • Scale — Scale factor for the XR display.

Scene Explorer Settings

Expanding a viewpoint in the Scene Explorer shows:

  • Description — Free-text description for the viewpoint.
  • Set Camera — Update the stored camera position to the current camera state.
  • Set Camera and Visibility Settings — Update the stored state including all visualisation settings.

Right-Click Context Menu

OptionDescription
Edit NameRename the item.
Move ToRestore the camera to this viewpoint.
XR PlacePlace the viewpoint in XR space.
Remove ItemDelete the item from the scene.

Scene Node Metadata

The following keys can be set in the scene node metadata to configure a viewpoint programmatically.

KeyTypeDescription
descriptionstringFree-text description for the viewpoint.
transform.headingdoubleCamera heading in degrees.
transform.pitchdoubleCamera pitch in degrees.
bounds.enabledboolShow the bounding sphere visualisation.
bounds.enabledPreviewboolShow a preview of the bounding sphere.
bounds.position.xdoubleX coordinate of the bounding sphere centre.
bounds.position.ydoubleY coordinate of the bounding sphere centre.
bounds.position.zdoubleZ coordinate of the bounding sphere centre.
bounds.radiusdoubleRadius of the bounding sphere in metres.
xr.position.xdoubleXR placement position X.
xr.position.ydoubleXR placement position Y.
xr.position.zdoubleXR placement position Z.
xr.scaledoubleXR display scale factor.
camera.moveSpeeddoubleCamera movement speed override (metres/second).
camera.lockAltitudeboolAltitude lock state override.
visualisation.modestringVisualisation mode to restore (e.g. default, colour, intensity, classification).

When a viewpoint is saved with visualisation settings, all current Settings visualisation values are also stored and restored on activation.