Overview#

The Live Session Selection Outline extension provides visual feedback for selections during a live collaboration session. It enhances the user experience by drawing outlines around selected objects in the USD stage, allowing users to easily distinguish between local and remote selections. Its real-time updates help maintain clarity in multi-user environments, supporting effective teamwork in Omniverse Kit SDK.

Functionality#

Selection Visualization
The extension monitors changes within the USD stage and dynamically updates the outline for selected primitives. It tracks both local and remote users’ selections, ensuring that each user’s activity is visually distinct.
Live Collaboration Support
By integrating with live session components, the extension continuously refreshes selection outlines as users update their selections. Core components like the multi-user selection manager and stage listener work together to respond to changes immediately.

Configuration#

Customizable Selection Icons
A key setting, maximum selection icons per user, allows you to limit the number of selection indicators displayed per user. This helps manage visual clutter in sessions with many users.
Outline Colors and Appearance
Settings for outline and saved outline colors are provided so that visual indicators can be tailored to match user preferences or workflow requirements.

Relationships#

Integrated with Live Session Components
The extension relies on modules such as omni.kit.usd.layers and omni.kit.collaboration.presence_layer to access live session data and manage user states.
UI and Scene Integration
Dependencies on omni.ui and omni.ui.scene enable the creation of manipulators and visual overlays that are key to rendering the dynamic selection outlines.

Considerations#

Live Session Environment
This extension is designed for live collaborative sessions. Its functionality becomes particularly apparent when multiple users are interacting with the same USD stage, so its benefits are best experienced in a collaborative setting.
Real-Time Updates
As the extension continuously monitors and refreshes visual cues based on stage events, there is an inherent reliance on the underlying stage listener and selection change notifications to trigger updates appropriately.