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 continue INVOKE

TCP prefix

GEOM*path/to/scene

SCENE*path/to/scene

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 active toggling instead of position-based animations.

Format Name

Forces subscenes to render in a specific format (for example, 16:9, 9:16). If empty, master scene format is used.

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 in
MAIN_SCENE*STAGE*DIRECTOR*BannerLyr SHOW $LOWERTHIRD
MAIN_SCENE*TREE*$BannerLyr*FUNCTION*Toggle*switch INVOKE
 
# IMPORTANT: In subscene mode, continue is required after switch
MAIN_SCENE*TREE*$BannerLyr*FUNCTION*Toggle*continue INVOKE