TDXMorph4
Changelog

Scene Launcher4.11

Paid · v4.11.4Real-time composition, enhanced

4.11.3

  • MIDI and OSC learn and route on the very first message. A one-shot OSC trigger needed two presses to map, and after reopening a project the first message on a mapped address was dropped.

4.11.2

  • Importing a PresetManager file keeps your scenes. A file with presets and no scenes replaced the presets and wiped the cue list. Scenes now stay, and a scene whose preset the file lacks goes back to None, as deleting that preset does. Behaviour change.
  • Fixed in the attached PresetManager (needs 4.4.4): Stop freezes a scene where it is instead of jumping to its target past the halfway point or after a Pause, and a looping track keeps looping when another finishes in the same frame.

4.11.1

  • The Preset Animator's duration readouts ship at 0 instead of a value left over from development.
  • A placeholder tooltip on an internal button template is gone, and the Preset Animator no longer names a development node.
  • Unused internal templates and leftover expression text are gone. Nothing changes in use.

4.11.0

The release audit. Items marked Behaviour change alter what an existing setup does, not only what a broken one does. Some fixes live in the attached PresetManager and need PresetManager 4.4.0.

  • Stop stops everything SceneLauncher started. The follow action is disarmed, the Sequence ends and a step waiting out its Delay is cancelled.
  • Only a scene's own morph fires its follow action. Another morph cutting in (the Morph button, an ElementsContainer, a script) used to fire it and launch the next scene. Needs PresetManager 4.4.0; an older one keeps the previous behaviour.
  • The last launch wins. Any new launch cancels launches still waiting out their Delay. Behaviour change: delayed launches no longer stack.
  • A scene's Script runs after its Delay, with the morph, and a newer launch or Stop cancels it. Behaviour change.
  • Pause works, and pausing a Sequence no longer ends it. Pause holds the running morph (fixed in PresetManager 4.4.0). Play/Pause shows playing again when a launch, Stop, Randomize or Interpolate ends the pause, without calling your onAction.
  • A refused import no longer deletes your scenes. The file is checked and its presets go to the PresetManager before any scene is replaced.
  • A scene with no target, or a deleted one, starts nothing and opens no dialog. Its Script still runs and a Sequence moves on. Behaviour change: Go on a scene aimed at a deleted preset is silent.
  • Target and Curve can be set back to None. A None target makes a script-only scene; a None curve morphs with the preset's own curve and no longer writes into the preset.
  • Launching a scene no longer changes the PresetManager's Morph Time and Morph Curve. Behaviour change: the CURVE readout shows the PresetManager's curve, not the last scene's.
  • A scene on Easein, Easeout or Exponentialeasing no longer jumps to its target, and Sigmoid, Quadratic and OddPolynomial scenes are no longer distorted.
  • A scene's Length or Curve edit reaches the morph with Multitrack off.
  • Your callbacks get the SceneLauncher and the real scene. Behaviour change: the first argument of onSceneLaunch and onAction is the SceneLauncher component. info['target'] carries the scene's preset, each Sequence step fires onSceneLaunch, and picking a scene's colour no longer selects it.
  • Deleting a scene keeps the transport on the scene it was on. Clear scenes and an import put it back at the start, and a finished Sequence stays on its last scene.
  • Duplicating a scene never overwrites another. A taken name gets a numeric suffix, and DuplicateScene returns the name it got.
  • Deleting or renaming a preset keeps the PresetManager's Target menu true.
  • A preset name with a quote or a backslash launches.
  • Create Animation follows your scene list. Behaviour change: every scene gets its own key, and a scene's Delay holds the previous scene. Scenes without a valid target are skipped, and the animation keeps its timing.
  • Totaldurations counts the Delays. Behaviour change.
  • A PresetManager 3.x is reported when attached, since follow actions, Sequence and the progress bar never ran with it.
  • Scene import and export use UTF-8, and importing a PresetSnap export into the PresetManager is refused instead of wiping it.
  • SceneLauncher ships with no scenes. 4.10.1 carried a leftover scene, A.
  • Nothing cooks while SceneLauncher is idle, and long unattended shows no longer pile up finished launches.
  • In the embedded ControlMapper, a pickup mapping on a parameter outside its range engages at the end of the control's travel instead of never.

4.10.1

  • A parameter driven by an expression or an export can no longer be mapped. A mapping writes values, which would replace the expression for good, so the embedded ControlMapper (now 1.0.5) refuses such a parameter and, in map mode, tells you which one is driven. SceneLauncher's own controls are all constant, so every one of them stays mappable. No other change.

4.9.1

  • The mapping editor follows the skin. Its rows and its selected row were fixed at Carbon's colours, so switching Lib/Look.Skin to Verdigris or Mono repainted the scene and preset lists and left the MIDI/OSC mapping list behind. Row, alternate row and selected row now read the same Look tokens the other two lists read, and the selected row takes the accent.

4.9.0

  • Follow actions, Repeat and Sequence fire again. They had been dead since the multi-track engine rewrite, along with three further defects behind that one. Selecting a scene row now seats the transport on that row, so Previous, Next and Repeat step from the row you pressed rather than from whatever launched last.
  • The DIST and CURVE selectors are clickable and mappable again. This reverses the 4.7.0 note below that a mapping on either goes dormant. Picking a value writes the attached PresetManager, and MIDI or OSC reaches them by the same path a click does. They still show what the engine is running, so launching a preset re-seats them from that preset's own stored curve.
  • Three skins. Lib/Look.Skin picks between Carbon, Verdigris and Mono; Carbon is the default, and the whole panel follows it.
  • The scene colour swatch is ParameterMorpher's picker. The pick is the click: the window is borderless at the pointer and closes on the pick or on a click outside, and its palette follows the skin. Lib/Look.Scenecolouring turns the swatch column off.
  • The MORPH and FOLLOW ACTION toggles read correctly again. Their lit state had gone dark on a dark ground, which looked switched off. They light near-white now, matching ParameterMorpher's container toggles.
  • The mapping editor is wider and no longer clips the target path.
  • FOLLOW ACTION reads ACTION, and the DIST and CURVE grounds match the buttons above them. The version bar changed colour and typeface, the panel gained a 4 px frame, and the progress bar is ParameterMorpher's GLSL bar, so its groove is visible at rest.

4.8.0: a scripting API (breaking)

You can now drive Scene Launcher from a script. Seventeen methods let a script, a MIDI/OSC handler or another component create, edit, reorder and launch scenes, and manage the presets in the attached PresetManager, without clicking through the lists.

sl = op('SceneLauncher')

sl.CreateScene('Intro', target='PresetA')
sl.SetSceneField('Intro', 'length', 4.0)
sl.SetSceneCurve('Intro', 'Easein')
sl.LaunchSceneByName('Intro')

sl.GetScenes()          # ['Intro', ...] in display order
sl.GetPresetNames()     # presets in the attached PresetManager
sl.ReorderScenes([2, 0, 1])

Scenes: GetScenes, GetScene, RenameScene, SetSceneField, SetSceneTarget, SetSceneCurve, DeleteScene, ClearScenes, ReorderScenes, LaunchSceneByName. Presets: GetPresetNames, GetPreset, StorePreset, RenamePreset, DeletePreset, ClearPresets, ReorderPresets.

Three things worth knowing:

  • Nothing pops up a dialog. A call that cannot be honoured returns False, [] or None. That matters if you are triggering these from a MIDI controller or a timeline: an automated path can never end up waiting for someone to click a button.
  • GetScene and GetPreset return copies. Editing what you get back does not change what is stored; use the setters for that.
  • ReorderScenes and ReorderPresets want a full permutation of the current row indices, as order[newRow] = oldRow. A partial list is refused rather than applied, because applying one would silently drop the rows you left out.

Clearing your presets now clears the scene targets too. Deleting or renaming a preset already updated every scene pointing at it. Clearing them all did not, so scenes were left aiming at presets that no longer existed and launching them quietly did nothing.

Breaking: seven internal methods were renamed. This only affects you if you were calling them from your own scripts, which was never documented as supported:

Old New
selectRow(row) SelectRow(row) — now a supported public method
launchCell(row) _launchCell(row)
assembleData() _assembleData()
getRandomColor() _randomColor()
updateTimeInfo(t) _updateTimeInfo(t)
createAnimationCOMP(...) _createAnimationCOMP(...)
disableBlending() _disableBlending()

Nothing inside the component was wired to the old names, so buttons, menus and mappings are unaffected.

4.7.1

  • The help sheet opens centred on the monitor TouchDesigner is running on. It used to open at the mouse pointer, against a fixed display index, so on a two-monitor desk it landed under the cursor and often on the screen you were not working on. The window now finds TouchDesigner's own display every time it opens, and centres there.

4.7.0

  • DIST and CURVE in the controls strip are readouts now, not pickers. They show what the attached PresetManager is set to, and they follow it live as scenes and presets launch. They were pickers before, but nothing kept the choice: every preset morph rewrites both values from the preset's own global block, and a scene row's curve overrides on top, so a manual pick was discarded by the next launch while the label went on showing it. The curve plot already read the engine directly, so the label and the plot beside it could disagree.
  • The distribution menu is built from the attached PresetManager, the way the curve menu already was. It used to be a fixed list of three applied by position.
  • The component's Colors page is gone, and Look is the single place to change the skin. All four of its colour groups live on the Looks popup, which the header icon opens and which already showed every other page. Row colours are the Listerrow and Listerrowalt tokens on the Listers page; the other three were already there as Highlight, Menubackground and Menubuttonface.
  • A saved MIDI or OSC mapping on the DIST or CURVE selector stops doing anything. Both are out of the mapping map now, because they are readouts. Nothing else in your mappings is touched, and a stray write from an old mapping corrects itself on the next launch.
  • SetMorphCurve() and SetRandomDistribution() are removed. They wrote PresetManager values that the next launch overwrote, so neither changed anything durable.

4.6.1

  • A mouse and key reference now opens inside the panel. The header gains a ? icon beside Look and Settings. It opens a single page covering every mouse action in the component: the scene list, the preset list, what the two lists share, the header itself and the four steps of map mode. The same sheet is on the component's own parameters as the Shortcuts pulse, at the bottom of the Config page.
  • The sheet spells out several behaviours that were previously only discoverable by trying them. A scene launches from its Go icon and from nowhere else, so a stray click on another cell can never fire a transition. Editing a scene's Length, or picking a Curve, also overwrites that value inside the scene's Target preset. Renaming a preset carries every scene aiming at it, and deleting one drops those scenes back to None. Rows re-order by pressing one and releasing on another, with no modifier key.
  • The About page's Help button is unchanged and still opens the tutorial showcase.
  • The help browser starts switched off and only starts the first time you open the sheet, so a project that never opens it never pays for it.

4.3.4

  • Mapping MIDI or OSC to the morph curve or random distribution selector now works. Learning a knob onto either looked like it worked and then had no effect: the selector moved internally while the visible dropdown and the value it sets stayed put. Every other mapped control was unaffected. ParameterMorpher 4.8.1 fixes the same fault; the two components carried identical code.

4.3.3

  • Internal quality work only. Nothing in the component behaves differently and your scenes and mappings are unaffected.

4.3.2

  • Mapping a menu parameter now reaches its last item. A learned menu mapping spans the full 0 to N range. Previously it stopped at N-1, and because TouchDesigner floors a menu value to an index, the last item was reachable from only 1 of 128 raw MIDI values while every other item got 8 or 9.
  • The header map icon is a crosshairs, replacing the MIDI DIN plug it had inherited. One icon covers both protocols, so a MIDI connector was the wrong picture.

4.3.0: the MIDI/OSC mapping rebuild (breaking)

Version 4.3.0 replaces the MIDI/OSC mapping subsystem outright. Mappings made in earlier versions are not carried forward, and a few parameters changed name, so any mappings you already have need to be made again.

What changes for you:

  • One map mode, not two. The separate MIDI and OSC icons in the header are now a single Map icon, shown whenever either a MIDI or an OSC input is wired on the Config page. Click it, click any control, then move a fader, knob or key to bind it. Both protocols share one list.
  • One mapping list. The Mappings parameter page is now Manage Mappings and Clear All Mappings (previously four pulses split across MIDI and OSC sections). The editor shows every mapping in one table.
  • Per-mapping range. Each mapping carries its own Min and Max, editable in the list. Previously all MIDI mappings shared one global input range.
  • Soft takeover. Each mapping can be set to pickup, which waits until the incoming control reaches the parameter's current value before taking over, instead of jumping to wherever the fader happens to sit. jump is the default and matches the old behaviour.
  • Dead mappings are visible. If a mapped control is renamed or removed, the row is marked (missing) in the list rather than silently doing nothing, and can be cleared with Prune dead mappings.
  • Retired parameters: Clearmidimappings, Managemidimappings, Clearoscmappings, Manageoscmappings, Togglelocationmidi, Togglelocationosc.

Anything can now be a mapping target, not just the built-in controls: a mapping stores a control and a parameter name, so any custom parameter can be driven.