TDXMorph4

Scene Launcher4.11

A cue list for your presetsReal-time composition, enhanced

Turn your presets into scenes, each with its own timing, curve and what happens next, then fire them one by one or let them run as a show. This page shows how to set it up, build scenes, launch them and control them from MIDI or OSC.

Open the panel

What you see

Drag SceneLauncher.tox into your network and click its viewer to open the panel. It starts empty, so attach a PresetManager first (see below).

Scene Launcher has no presets of its own. It plays the presets stored in a PresetManager you attach.

Setup

Attaching a PresetManager

Scene Launcher needs a PresetManager to play. Any component that already holds one works too, like a ParameterMorpher container.

Do thisTo
Store presets in a PresetManager

Give it something to play. Store at least two, or there is nothing to cue.

Set Preset Manager on the Config page

Attach it. The preset list fills in right away.

Pulse Refresh on the Config page

Update the lists if they look out of date.

Scenes

Building scenes

A scene is one preset with its own timing, curve and follow action.

Do thisTo
Right-click empty space in the scene list

Open the scene menu: New scene, Duplicate, Clear scenes, Clear actions, Clear scripts, Export presets, Import presets and Refresh.

Right-click a Target cell

Pick the preset this scene plays.

Right-click a Curve cell

Pick the shape of the move.

Right-click an Action cell

Pick what happens when the scene finishes.

Click a Scene, Length, Delay or Script cell

Type a new value.

Click the colour swatch

Pick the scene's colour. The picker closes when you pick, or when you click outside it.

Click the trash icon

Delete the scene.

Press on a row and release on another

Move the row there. No key needed.

Changing a scene's Length or Curve also changes that value inside its target preset. The scene is in charge of its own timing. A Curve of None leaves the preset alone.
Columns

What each cell means

  • Scene: the scene's name.
  • Launch icon: the button that fires the scene.
  • Length: how long the move to the preset takes.
  • Delay: how long to wait before the move starts.
  • Target: the preset it plays. None makes a scene that only runs its Script.
  • Curve: the shape of the move. None uses the preset's own curve.
  • Action: what happens when the scene finishes.
  • Script: a script that runs when the scene launches.

Turn off Enable delays or Enable scripting to hide the Delay or Script column. Both start on. A hidden script still runs.

Launch

Launching scenes

Do thisTo
Click the launch icon in a row

Launch that scene. It is the only thing in the list that launches, so editing a cell never fires a scene by accident.

  • Delay: the scene waits this long, then moves and runs its Script.
  • The last launch wins: any new launch cancels scenes still waiting out their Delay. Delayed launches never pile up.
  • No target: a scene whose Target is None, or a preset that no longer exists, starts no move and shows no message. Its Script still runs.
  • Total time: the Info page shows the length of the whole list: every scene's Length plus its Delay.
Cue list

Follow actions

Give each scene an Action and the launcher runs your scenes as a cue list. The Action fires when the scene's own move finishes.

  • None: stop there.
  • Repeat: play the same scene again.
  • Previous: play the scene above.
  • Next: play the scene below.
  • First: go back to the first scene.
  • Last: jump to the last scene.
  • Any: play a random scene.
  • Other: play a random scene other than this one.
Only the scene's own move fires its Action. If something else starts a move in the PresetManager, the Action is cancelled.
Transport

The controls

Do thisTo
Click a scene row

Put the transport on that scene. Previous, Next and Repeat step from there.

Go

Launch the selected scene.

Previous, Next, Repeat

Step to the scene above or below, or play this one again.

Sequence

Play the whole list in order, ignoring the Action column. When it finishes, it stays on the last scene.

Play/Pause

Hold the running move, or let it carry on. Pausing a Sequence does not end it.

Stop

Stop everything Scene Launcher started: the move, any scene waiting out its Delay, the follow action and a running Sequence.

DIST and CURVE

Show and set the PresetManager's random distribution and curve. Launching a preset changes them to that preset's own values.

A new launch or Stop ends a pause, and Play/Pause goes back to playing by itself.

Presets

Presets and files

  • Rename a preset: every scene aimed at it follows the new name.
  • Delete a preset: every scene aimed at it goes back to None.
  • Reorder: press on a preset and release on another, as in the scene list.
  • Export presets: saves your scenes and presets together in one file.
  • Import presets: loads such a file. A file with presets but no scenes keeps your scenes. A file that is refused changes nothing.
MIDI and OSC

Controlling it from hardware

Set Osc or Midi on the Config page to your input CHOP. The Map icon then shows in the header.

Do thisTo
Click Map

Turn on map mode. Every control you can map shows a badge, and mapped ones look different.

Click a badge

Arm that control. Its badge blinks while it listens. Click again to disarm.

Move a fader, knob or key

Bind it to the armed control. Learning it again moves the mapping instead of adding a second one.

Pulse Manage Mappings

Open the mapping list to edit or remove mappings.

Pulse Clear All Mappings

Remove every mapping.

  • Min and Max: the range each mapping covers.
  • jump: the control takes over right away. This is the default.
  • pickup: waits until your fader reaches the current value before taking over, so nothing jumps.
  • (missing): the mapped control is gone. Prune dead mappings clears these rows.
A parameter driven by an expression or an export cannot be mapped, because the mapping would replace it. Map mode tells you which one it is.
Look

Look and help

Do thisTo
Click the Look icon in the header

Open the Looks popup, where you change the skin and colours.

Set Skin

Pick Carbon (the default), Verdigris or Mono. The whole panel follows.

Turn off Scene Colouring

Hide the colour swatch column.

Click ? in the header

Open a one page sheet of every mouse action, without leaving TouchDesigner.

Pulse Shortcuts on the Config page

Open the same sheet.

Click Help on the About page

Open the tutorial showcase.