Media

A Media item displays an image, panorama, or video at a specific location in the scene. Media items can be used to embed site photographs, orientated images, 360° panoramas, or photo spheres into a point cloud scene.

Creating a Media Item

  • Click the Add Media button in the toolbar, then click in the scene to place the item.
  • Drag and Drop — Drag a PNG, JPG, or TIFF image file directly from your file explorer into the scene viewport to create a media item at the drop location.

Ribbon Settings

Basic

  • Image Type — Controls how the image is displayed:
    • Standard — A billboard image that always faces the camera.
    • Orientated Image — An image with configurable position and orientation.
    • Panorama — The image is projected onto a panoramic cylinder.
    • Photo Sphere — The image is projected onto a full sphere.
    • Screen — The image is displayed as a screen-space overlay.
  • Thumbnail Size — The display size of the image in the scene.
  • Reload Time (secs) — How often the image is refreshed. Useful for live camera feeds or images that update over time.

Transform (Orientated Image)

When Orientated Image is selected, transform controls become available:

  • Rotation Y / P / R — Yaw, pitch, and roll of the image orientation.
  • Scale — Uniform scale factor for the image.

Style

  • Transparency — Transparency level of the image (0 = fully transparent, 1 = fully opaque).

Scene Explorer Settings

Expanding a media item shows:

  • URL / Path — The source URL or file path for the image.
  • GPS Time — GPS timestamp associated with the image capture.

Right-Click Context Menu

OptionDescription
Edit NameRename the item.
Move ToMove the camera to frame the media item.
Remove ItemDelete the item from the scene.

Scene Node Metadata

The following keys can be set in the scene node metadata to configure media items programmatically.

KeyTypeDescription
imagetypestringDisplay type: standard, orientated, panorama, photosphere, or screen.
imagesizestringDisplay size hint: standard, small, or large.
reloadRatedoubleImage refresh interval in seconds (0 = no refresh).
transparencydoubleImage transparency (0.0 = transparent, 1.0 = opaque).
transform.rotation.ydoubleYaw rotation in degrees (orientated image).
transform.rotation.pdoublePitch rotation in degrees (orientated image).
transform.rotation.rdoubleRoll rotation in degrees (orientated image).
transform.scaledoubleUniform scale factor.
gpstimedoubleGPS timestamp of the image capture.
gpsstatusintGPS fix status code.
thumbstringBase64-encoded thumbnail image data.