Scenes

Scenes are collections of 3D objects — point clouds, imagery, polygon models, and more — that you load in udStream or another udSDK product (for example the Unreal and Unity plugins). Scenes are stored in a project; this page covers working with them from the web interface.

Seeing the scene list requires the View Scene List permission. If you don't have it, the scene list is hidden.

Viewing Scenes

Scenes are shown as cards, each with a thumbnail (when one has been saved), the scene name, and its tags. Use Refresh to reload the list.

Opening a Scene

Scenes are loaded in udSDK applications rather than viewed directly in the portal. Each scene card offers:

• View in udStream web — open the scene in the browser-based udStream.
• Copy Scene Code — copy the scene's code to the clipboard so you can paste it into udStream (or another udSDK application) to open it there.

Loading a scene requires the Read Scenes permission; editing and collaborating on it requires Edit Scenes.

Uploading Scenes

Scenes are normally created and saved from udStream. To bring in an existing scene document, use Upload your .udjson scenes to upload one or more .udjson files. Uploaded scenes are placed in the folder you are currently viewing. Uploading requires the Manage Scenes permission.

Organising Scenes into Folders

Scenes can be arranged into folders to keep large projects manageable. Folders are virtual — a scene simply records the path of the folder it belongs to, so there is nothing to create or delete separately; a folder exists for as long as at least one scene refers to it.

• A breadcrumb trail shows the folder you are viewing. Click All scenes or any crumb to navigate back up.
• Sub-folders of the current folder appear alongside its scenes. Click a folder to open it.
• To move a scene, use its Move action and enter a folder path such as Buildings/Level 1. Leave the path blank to move the scene back to the root. Entering a path that doesn't exist yet creates that folder.

Moving a scene requires the Edit Scenes permission.

Tags

Tags let you label and group scenes. The set of available tags is defined per project in the project settings; each tag can be given a colour. Defining the tag catalogue requires the Manage Projects permission.

To apply or remove tags on a scene, use the scene's Edit tags action and toggle the tags you want. Applying tags requires the Edit Scenes permission.

Filtering and Searching

The scene list can be narrowed to find scenes quickly:

• Search — type in the search box to filter the current folder by scene name. The search is case-insensitive and updates as you type; clear it with the × button.
• Filter by tag — click one or more tags. Choose Any to show scenes that have at least one of the selected tags, or All to show only scenes that have every selected tag.
• Untagged — show only scenes that have no tags. This is mutually exclusive with selecting specific tags.
• Clear — remove all active tag and search filters.

Filtering and search apply within the folder you are currently viewing.

Sharing Scenes

A scene can be marked as shared so other members can access it. Changing a scene's shared state requires the Share Scenes permission and is done from udStream and other udSDK applications.

Thumbnails

A scene's thumbnail is the preview image shown on its card. Thumbnails are saved by udSDK applications (a PNG up to 320×180). Scenes without a saved thumbnail simply show no preview image.

Deleting Scenes

Delete a scene from its card's Delete action. This requires the Manage Scenes permission and cannot be undone.