Create scene timeline
create_scene_timelineConstruct a scrubbable show timeline with ordered scenes, each recalling a stored cue on a target COMP. Playback is driven by a Timer-CHOP playhead with controls for Play, Pause, Stop, Seek, Rate, and Loop.
Instructions
Build a scrubbable show timeline: a single Timer-CHOP playhead drives ordered scenes that recall cues on a target COMP. Sits above create_cue_sequencer (beat-quantized) and create_scheduler (event-firing) as the show's master clock. Exposes Play/Pause/Stop/Seek/Rate/Loop/Active_Scene custom pars + a playhead Null CHOP (t_seconds, t_norm, scene_idx, scene_t). Consumes the foundation setlist schema: when setlist_path is given, each scene's setlist_slot is mirrored into tdmcp_scenes for downstream tools. Bars→seconds conversion uses BPM 120 + 4 beats-per-bar at build time (no auto-rescale on tempo change).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | COMP that owns the cues (tdmcp_cues). Store scenes' cues first with manage_cue. | /project1 |
| scenes | Yes | Ordered scene list (sorted by `start` at build time). Overlaps drive morphs. | |
| units | No | Input unit for `start`/`duration`/`morph_in_seconds`. 'bars' is converted to seconds at build time using BPM 120 + 4 beats-per-bar (no auto-rescale on tempo change). | seconds |
| loop | No | End of last scene → wrap to 0. | |
| rate | No | Playback rate multiplier (Timer CHOP speed). Exposed as a live custom par. | |
| autoplay | No | Pulse the Timer's start on cook when true. | |
| setlist_path | No | OPTIONAL path to a DAT holding the foundation-setlist JSON. When present, scene.setlist_slot is stored alongside each scene in tdmcp_scenes for downstream tools. | |
| name | No | Engine COMP name. | scene_timeline |
| parent_path | No | Parent path where the engine COMP lives. | /project1 |