What is a Subcomposition?

Subcompositions are your Composition's main structural components and are integral in making your composition controllable by a Control Application.

Each Subcomposition at the top level of your Composition Tree in Composer represents an individual overlay and is required to create the Layer Logic used in Singular's control applications. Subcompositions can be assigned Control Properties and can be connected to external data sources

A Subcomposition can consist of Widgets, Groups, and even other Subcompositions, which, when nested within a parent Subcomposition, create an overlay. Some advanced widgets, such as the Grid Widget, will even create their own sub-compositions that they reference.

Adding a new Subcomposition


Nesting Subcompositions is Important For:

Separating your Composer content into separate overlays

Your first step when building a new composition should be to create separate Subcompositions for each overlay within your root group folder. Within these, nest all the widgets required to build each overlay.

Adding animations, controls, and effects to multiple elements

By grouping elements together within a Subcomposition, you can add controls, effects, and animations to all widgets within that Subcomposition. For example, instead of having the same animation for three separate Subcompositions, you can have one animation tied to a single Subcomposition containing your three elements.

Top layer is important if using Studio to control

If you plan to use Singular's Studio as your control application, keep in mind that only the Subcompositions that sit in the top layer of a Composition can be controlled by Studio, as these are the individual overlays. These are also the only Subcompositions you can assign to a specific Logic Layer. 

If you're using a custom control application, however, those can be built to control nested Subcompositions as well.

Was this article helpful?
2 out of 2 found this helpful



Please sign in to leave a comment.