Sequencing Scenes

Create multi-scene compositions using mode="sequence" on a timegroup.

Basic Sequence

Children play one after another. Total duration is the sum of all children.

Sequences with Overlap

Add overlap to create shared time between adjacent items — the foundation for transitions.

Total duration with overlap: sum(children) - (overlap × (count - 1)). Three 3s scenes with 1s overlap = 7s.

See transitions.md for crossfade and slide effects during overlap.

Nested Sequences

A sequence can contain other sequences. The inner sequence resolves to a single duration.

<ef-timegroup mode="sequence" overlap="1s">
  <ef-timegroup mode="sequence">
    <ef-timegroup mode="fixed" duration="3s">Sub A1</ef-timegroup>
    <ef-timegroup mode="fixed" duration="2s">Sub A2</ef-timegroup>
  </ef-timegroup>
  <ef-timegroup mode="fixed" duration="4s">Scene B</ef-timegroup>
</ef-timegroup>

The inner sequence (5s total) is treated as a single 5s item in the outer sequence.

Mixed Content

Sequences work with any element — video, images, text, or combinations:

Background Track Pattern

Wrap a sequence with a contain parent and add a fit sibling for a background that spans the full timeline:

<ef-timegroup mode="contain">
  <ef-timegroup mode="sequence">
    <ef-timegroup mode="fixed" duration="3s">Intro</ef-timegroup>
    <ef-timegroup mode="fixed" duration="10s">Main</ef-timegroup>
    <ef-timegroup mode="fixed" duration="2s">Outro</ef-timegroup>
  </ef-timegroup>
  <ef-audio src="music.mp3" mode="fit"></ef-audio>
</ef-timegroup>

See Also

• timegroup-modes.md — mode explanations
• transitions.md — crossfade and slide transitions
• time-model.md — how time propagates through sequences