Merged Geometry vs Subscene Mode
By default Object scenes are handled as subscenes. This means the scene tree of the object scene is being added as subtree into the master scene. This is more efficient and does not require to create merged geometries, and it supports adaptive format handling as well.
In Merged Geometry mode, the object scene is brought as a merged geometry into the master scene.
Information: We recommend to use Subscene Mode as it is much more efficient than the Merged Geometry mode. For backward compatibility, you can set TransitionLogicUseMergedGeometries = 0 in the Viz Configuration file.
Merged Geometry (GEOM*) | Subscene Mode (SCENE*) | |
|---|---|---|
How it loads | Object scene tree is merged directly into the master scene tree | Object scene is loaded as a separate scene reference (scene-in-scene) |
Performance | Faster (single draw call tree) | Slight overhead (separate scene context) |
Box Transformation | ❌ Not supported | ✅ Supported |
Flexbox | ❌ Not supported | ✅ Supported |
Object-local directors | Merged into master stage | Preserved in subscene scope |
After switch | Works automatically | Requires explicit |
TCP prefix |
|
|
Toggle Adaptive Properties
When using subscene mode with adaptive/responsive layouts:
Toggle Property | When to Enable |
|---|---|
Support Box Transformation | Object scenes use Box Transformation for responsive positioning. |
Support Flexbox layout | Object scenes use Flexbox for layout. Toggle uses |
Format Name | Forces subscenes to render in a specific format (for example, |
Save and reload after changing adaptive properties: After enabling Support Box Transformation or Support Flexbox, the scene must be saved and reloaded to regenerate the Toggle's internal structure.
Subscene Mode TCP Workflow
# Load via SCENE reference (not GEOM)MAIN_SCENE*TREE*$BannerLyr*FUNCTION*Toggle*object SET SCENE*News/LowerThird# Animate inMAIN_SCENE*STAGE*DIRECTOR*BannerLyr SHOW $LOWERTHIRDMAIN_SCENE*TREE*$BannerLyr*FUNCTION*Toggle*switch INVOKE# IMPORTANT: In subscene mode, continue is required after switchMAIN_SCENE*TREE*$BannerLyr*FUNCTION*Toggle*continue INVOKE