The Composition View

The Composition panel contains the Timeline, Track Editor, and Playback Controls. In the Default Layout, this panel appears at the bottom of the HoloEdit UI, below the Viewport and next to the Project View.


The Composition View Allows the user to interactively view and edit the Composition in the Timeline, and create Stages and Intervals for processing.

The Composition View is made up of four major pieces

  1. The Track View, on the left

  2. The Composition Toolbar, the thin strip directly above the Track View

  3. The Timeline

  4. The Timeline And Playback Controls, along the bottom of the Timeline

  5. The Timeline Toolbar, between the Track View and the Timeline

The Track View

Track Controls


the Track Controls are located in the top left of the Composition panel, on the same row as the time display.

  • Add Track: Represented with a “Rows +” icon, the Add Track button creates a new empty Track at the bottom of the Composition

  • Delete: Represented with a “Trashcan” icon, the Delete button deletes the currently selected Tracks, Stages, or intervals

The Timeline Toolbar


The Timeline Toolbar, located in the vertical strip in between the track view and the timeline, contains tools for editing intervals in the Timeline. In HoloEdit 2021.1, this contains two tools.

The Arrow Tool


The arrow tool is selected automatically after opening HoloEdit. This is the main tool for selecting and editing intervals in HoloEdit, and lets you perform all normal editing tasks such as creating and modifying intervals.

The Razor Tool


The Razor Tool is a special tool for editing Intervals in the Timeline. Using the Razor tool, you can cut existing intervals into two new intervals with Left Click. Additionally, you can perform this function across an entire Track by holding Shift and left clicking.

Intervals created through the Razor Tool will inherit the settings of the original Interval that was cut.



Processing and editing work in HoloEdit is done through Stages.

Stages are individual processes that add or manipulate the data streams contained in a Track. Each Stage represents a kind of process, and can contain one or more intervals specifying frame ranges and custom settings for processing. Each Stage corresponds to a row on the Timeline where intervals can be created for that Stage.

Stages can be clicked on and selected to display their details and settings in the Inspector panel.

The specific settings available and their effects depend on the Stage. See Stage Types for more details.

For more information on editing settings in the Inspector, see Inspector - Settings.

You can use the Interval Settings to configure the options provided by the Stage independently per interval.

When one or more Tracks are visible, a small dot appears to the left of Stages with samples currently being displayed in the viewport.

Stage Controls

The Stage Controls for each Stage can be accessed by clicking on the three dots to the right of a Stage name, or by right clicking on the Stage name.

  • Propagate Intervals To Next Stage: Create new Intervals on the subsequent Stage matching each Interval present in the Stage. Does nothing if no Stage exists below the specified Stage. Existing Intervals will be overwritten if they overlap with the new Intervals

  • Copy Settings: Copies all edited settings on the current Stage.

  • Paste Settings: Pastes the last copied Stage settings to this Stage.

  • Clear Stage Intervals: Removes every Interval from the Stage. As with Interval removal elsewhere in HoloEdit, any data streams in the stage will be preserved.

  • Clear Stage Data: Removes all data streams from the stage. Intervals are left intact.

  • Delete: Delete the Stage and its contents.

Creating And Arranging Stages

To create a Stage for any Interval, press the “Add Stage” button at the bottom of that Track’s Stage list, then choose a Stage type from the drop down menu.

Stages can be re-arranged by clicking and dragging on the Stage name, and releasing the Stage at any point within its parent Track. Rearranging Stages that have been processed can cause Intervals to be labeled as Dirty (see Editing Compositions - Intervals for more information).

Stage Selections

Multiple Stages can be selected at once by shift or ctrl clicking on multiple Stages. Each selected Stage will be highlighted in the Track View UI.

When multiple Stages are selected, the most recently selected two Stages will be available for Comparison View, and the most recently selected Texture or Animation stream and all selected Mesh Streams will be displayed in the Inspector. Additionally, the “Delete” button (Trash Can Icon) at the top of the Track View will delete all selected Stages and intervals currently selected.


../_images/Visibility.PNG ../_images/Visibilityoff.PNG

The “Eye” icon to the left of a Track or Stage can be clicked to show or hide that Track/Stage.

During export, only visible Tracks will contribute to the export.


../_images/Lock.PNG ../_images/UnLock.PNG

The Padlock Icons to the left of the Eye Icons can be clicked to toggle Locking a Stage or Track. When an item in the Composition is Locked, its Intervals will be greyed out in the Track Editor, and cannot be accidentally resized, moved, or deleted. Additionally, most of the Stage Controls are unavailable via right click or via the three dots icon to the right of the Stage name. Locked Stages and Intervals will be placed in read-only mode.

Locking may be applied at either the Track or Stage level. When a Track is locked, all of the Stages contained within are also locked, signified by greyed-out closed padlock icons. Unlocking the Track will also unlock the corresponding Stages if they inherited their lock status from the Track. Stages that were locked individually will be signified with the lit up closed padlock icon and will remain locked regardless of the Track state.

The Composition Toolbar

The Composition Toolbar is the thin strip above the Track Editor, directly to the left of the Time Ruler. The Composition Toolbar contains tools for editing the Composition:

Current Time display

The Current Time Display shows a numerical representation of the current time represented by the playhead. Clicking on the “s / f “ text to the right of the time toggles the display between Frame and Timecode formats. Left clicking on the current time allows you type in a specific value to update the playhead.

The Timeline

The Timeline is made up of three parts

  • The Time Ruler, the topmost strip displaying the timing of your Composition for navigation

  • The Interval Editor, the large area directly below the Time Ruler

  • The Timeline Controls, a bar stretching along the bottom of the Timeline


The Interval Editor is the primary workspace for assembling and editing Tracks. Each entry in the Interval Editor is aligned to a Stage in the Track View, to the left. The Interval Editor is where you create, arrange, and inspect Intervals.

The Playhead


The Playhead is the pink line and arrow block positioned on the Timeline. This represents the current Timeline in HoloEdit.


You can Zoom in and out on the Time Ruler and Interval Editor with Mousewheel, or by clicking and dragging on the pink “Timeline Zoom” bar at the very top of the Timeline. You can Pan the Timeline by clicking and dragging the Middle Mouse Button anywhere in the Timeline view. Additionally, you can frame the Composition by selecting the Frame Timeline option in the View menu, or pressing the “G” Hotkey. This will zoom and pan the Timeline to frame the entire Composition if no selection is present, or a portion based on the Stage and Interval selection.

Track Time Selections

Within the portion of the track corresponding to a stage, You can left click and drag on empty Track space in the Interval Editor to create a “Track time selection”, indicated by a block of time highlighted in dark blue. To select multiple intervals, You can click and drag over existing intervals, or shift left click on intervals.

Right Clicking in the Interval Editor will bring up a context sensitive menu.

Right clicking into the Timeline, the options are:

  • Execute all Intervals In Stage: All intervals in the stage will be executed for processing. See Processing & Jobs for more details

  • Execute All Intervals Missing Outputs: Every interval containing incomplete work (frames not executed, frames with errors, etc) will be executed as a single job. See Processing & Jobs for more details

  • Propagate intervals To Next Stage: Create new Intervals on the subsequent Stage matching each interval present in the Stage. Does nothing if no Stage exists below the specified Stage. Existing intervals will be overwritten if they overlap with the new intervals

Right Clicking on a “Track Time Selection”, the options are:

  • Add Interval(s): Create interval(s) in selected time & Stage(s)

  • Clear data: This removes data present in the selection, but not currently contained in an interval (as a product of processing an interval and then resizing or deleting it)

Right clicking on an Interval the options are:

  • Execute: Executes incomplete data in the selected intervals for processing. HoloEdit will create a job that processes the necessary work to correct failed, dirty, or unprocessed frames and segments. See Processing & Jobs for more details

  • Execute Missing: Execute any selected interval containing incomplete (failed or not yet processed) frames. See Processing & Jobs for more details

  • Execute Dirtied: Execute dirtied frames in any selected intervals. See Interval Dirtiness for more details on Interval Dirtiness

  • Execute Failed: Execute failed data in any selected intervals. HoloEdit will create a job that processes the necessary work to correct failed frames or segments.

  • Export: Export only the contents of the selected interval(s). See Export for more details

  • Delete: Remove the selected Intervals from the Track

  • Clear Data: Remove generated data and configuration for the selected Intervals

The Execute Missing, Execute Dirtied, and Execute Failed options are context sensitive, and may not appear in the right click menu if appropriate samples are not present in your selected interval(s).


When adjusting an interval, by default the ends will automatically snap to the ends of other intervals on the Timeline, even on other Stages. The items being snapped to are highlighted in white. This can be disabled via the “Snap Interval” button in the Timeline Controls. See Timeline and Playback Controls for more information.

Loop Selection


Playback is constrained by the Loop Selection, the grey bar with pink handles located directly below the Time Ruler and above the Interval Editor. This can be resized by clicking and dragging the pink handles on either side, and moved by clicking and dragging on the body of the selection. Playback will stop and start within these boundaries.

Timeline and Playback Controls


The Playback Controls bar contains controls for playback and some Timeline settings.

From Left to Right, the controls are:

Playback Controls

  • Start: Set the playhead to the first frame in the Composition.

  • Previous Interval: Set the playhead to the closest preceding Interval Start

  • Previous Frame: Step back one frame

  • Play Backwards: Play the current Composition in reverse

  • Play Forwards: Play the current Composition

  • Next Frame: Step forward one frame

  • Next Interval: Set the playhead to the next closest Interval Start

  • End: Set the playhead to the last frame in the Composition.

Snap Settings

  • Snap To Frame: Not optional In 2021.1

  • Snap Interval: Toggles Interval snapping when scaling or moving intervals

  • Snap To Playhead: Disabled in 2021.1

Loop Controls

  • Loop: Toggles looping when Playing within the current Loop Range

  • Reset Loop Markers: Resets the Loop selection to run from the first frame in the Composition to the end of the Composition

Additionally, you can scrub through the current animation by clicking and dragging the Playhead on the Time Ruler.

Playback is constrained by the Loop Selection, the grey bar with pink handles located directly below the Time Ruler and above the Interval Editor. This can be resized by clicking and dragging the pink handles on either side, and moved by clicking and dragging on the body of the selection. Playback will stop and start within these boundaries.

Track And Composition Results

To understand your HoloEdit Composition, it helps to understand the Track Result and Composition Result. HoloEdit is a non-linear editor, which means that rather than having a single, edited version of your Volumetric Clip, the state of the Track at each individual stage is available at any time. In HoloEdit, a Track Result is the state of your entire clip at any given point in a track. This contains any new edits to your data applied by the current Stage, in addition to any non-edited data inherited from all previous stages. In HoloEdit this is sometimes called the Waterfall, because un-edited data flows down from through previous stages like a waterfall.

The Track Result is used whenever a clip is exported, displayed in the HoloEdit viewport, or dispatched for processing in a Stage. This is the product of each Stage that has been processed in your Track. The final product of every visible Track combined is called the Composition Result.

Samples contained in hidden Stages or that have not been completely processed are excluded from the Track Result displayed in the Viewport and in Exports.

When Executing a stage, it helps to understand the Result up to the point in the track where that Stage appears. If the required data for your Stage is not present in the current Result it will not be possible to execute. To help understand the concept of the Track Result, please read the example below.

For example, imagine a Track with three Stages

The first Stage is a Load Asset Stage with a single interval from frames 0 - 200

The next is a Stabilize Stage with intervals from 0-100, 101-150, and 151-200. The first and third intervals are complete, but the second has failed.

The final Stage is a SSDR Stage, with corresponding intervals at 0-100, 101-150, and 151-200. The first and third have been successfully processed, but the second is blocked by the preceding Stage.

The Track Result, in this case, will be frames 0-100 from Stage 3, frames 101-150 from Stage 1, and 151-200 from Stage 3. This Track Result is what is visible in the viewport with the Track selected, and is also what would be output from holoedit when exported.

Note: when an Interval is Blocked by an incomplete interval in a previous Stage, the entire Interval will fail to compute. Ie, in the previous example, if there had been two intervals in the third Stage – 0-100 and 101-200, the entire 101-200 interval would be blocked by the failed 101-150 interval in the second Stage.