Comment on page

Composer reference

Get to know Composer, where you create and edit custom overlays
Singular’s overlay builder, Composer, is where you create and edit custom HTML5 overlays. On this page, you'll find an overview of the layout of Composer and and a list of Composer shortcut hotkeys.

Composer layout

The main areas of Composer

Composer contains four main areas:
  1. 1.
    Composition tree
  2. 2.
    Property panel
  3. 3.
    Output window
  4. 4.
    Data interface and control panel
Main areas of Composer

1. Composition tree

This panel shows the organizational structure of the elements in a composition or sub-composition.

2. Property panel

Here, various editors are available to modify and change the parameters of a selected widget, group, or sub-composition.

3. Output window

In this panel, you can preview overlays.

4. Data interface and control panel

This panel allows you to define links to external data and specify widget properties you want to expose to external control applications or the Singular APIs.

A closer look at each area of Composer

A closer look at Composer

Areas of the composition tree

1.1 Composition breadcrumb
Here you can see the size and name of the composition you are working on.
1.2 Composition tree toolbar
This toolbar allows you to add, copy, and paste elements, such as widgets, groups, and sub-compositions, into a composition. It also contains a search bar, undo/redo buttons, open/close all groups buttons, and the composition navigator button.
1.3 Composition navigator
This floating user interface is for navigating between sub-compositions within a composition. Here you can trigger in and out timeline animations, assign a sub-composition to a logic layer, and adjust transition timers. Access it by selecting the composition navigator button in the composition tree toolbar or by using the shortcut command + F (Mac) or control + F (PC).

Areas of the property panel

2.1 Composition script editor
Above the property panel is a button to open the composition script editor and another to open the composition script editor in safe mode.

Areas of the output window

3.1 Preview toolbar
In this toolbar within the output window, you can turn on/off bounding boxes, choose the aspect ratio of the device or the composition you want to build for, take a thumbnail snap of the frame, or open a new tab to see the output of your work on a clean page.
3.2 In and Out buttons
These buttons trigger In and Out animations.
3.3 Singular support button
The support button opens the Singular Support widget.

Composer shortcuts

General composer shortcuts

The following general Composer shortcuts are shown next to the menu items or as tool tips (accessed by hovering over):
Adding a group, widget, or sub-composition
Undo shortcut
  • CMD/CTRL + G: Add a new group
  • CMD/CTRL + B: Add a new widget
  • CMD/CTRL + S: Add a new sub-composition
  • CMD/CTRL + F: Open the composition navigator
  • CMD/CTRL + X: Cut
  • CMD/CTRL + C: Copy
  • CMD/CTRL + V: Paste
  • CMD/CTRL + Z: Undo
  • CMD/CTRL + Y: Redo

Composition tree navigation shortcuts

Composition tree navigation shortcuts are not shown in the UI. To activate them, click on the composition tree. They allow you to navigate through the composition tree quickly and easily:
  • Right, left, up, and down cursors
  • Enter
  • Space bar
  • H

Right, left, up and down cursors

These arrow keys allow you to select tree elements
Moves from a group to the first child element. If the selected element is a sub-composition, the right key will open this sub-composition and select the first element.
Moves from an element to its group and then to its parent composition.
Moves up, vertically, within that section of the tree.
Moves down, vertically, within that section of the tree.

Addition composition tree shortcuts

Changes the selected element name.
Space bar
Opens and closes the selected group.
Space bar
H key
Toggles visibility of the selected element.
H key