TDXMorph4

Parameter Morpher4.18

Presets and morphing for any parameterReal-time composition, enhanced

Gather the parameters you care about into one panel, store how they look as presets, and morph smoothly between them. This page shows what is on screen and every way to work with it.

Open the panel

What you see

Drag ParameterMorpher.tox into your network, then click the component's viewer to open the panel. It starts empty on purpose: click Create in the header to make your first container.

Moving an element's slider moves the real parameter, so the panel is a live remote for your network.

Setup

Containers

A container holds a group of parameters and its own presets. You can have as many as you like.

Do thisTo
Click Create in the header

Add a new container. Click again for another one.

Shift+right-click a container's name

Rename it.

Turn on Horizontal on the Dimensions page

Place containers side by side instead of stacked.

Turn on Pages mode

Show one container at a time, at full height.

The page arrows in the header

Step to the previous or next container. They stop at the first and last one.

The page menu in the header

Jump to a container by name. You can also set the Page parameter.

Paging only changes what you see. A container you paged away from keeps morphing and keeps answering its MIDI and OSC controls. The arrows and menu stay greyed out until Pages mode is on.

Parameters

Adding parameters

Each parameter you add becomes an element: a row with its name and a slider, toggle or menu that drives the original parameter.

Do thisTo
Drag a single parameter onto a container

Add one element for it. Works for any parameter, built in or custom.

Drag a whole node onto a container or onto an element row

Add one element for each of its custom parameters. A node with no custom parameters adds nothing, so drag its parameters one by one instead.

Shift+left-click an element's name

Put it back to the value and range it had when you added it.

Shift+right-click an element's name

Rename it.

Alt+drag an element onto another

Swap their places.

If a parameter is driven by an expression or an export, adding it keeps it driven. Moving the element is what takes it over.

Deleting an element also removes its values from every preset. You are asked first, and told how many presets that touches.

Presets

Storing and recalling presets

Each container has its own row of preset slots. Store at least two presets to see a morph.

Do thisTo
Shift+left-click an empty slot

Store the current value of every element in that container. On a stored slot, it overwrites it.

Left-click a stored slot

Morph to that preset, over its own stored time and curve.

Ctrl+left-click a slot

Jump straight to the preset, with no morph.

Ctrl+right-click a slot

Morph over the container's Morph Time instead of the preset's own time. Handy for a quick check.

Shift+right-click a slot

Delete the preset.

Shift+middle-click a stored slot

Freeze or unfreeze the elements, so they cannot be nudged by accident.

Alt+drag one stored slot onto another

Swap which preset each button plays.

Locked elements keep their value when you recall a preset, with a plain click or a Ctrl+click.

If you click a preset before adding any elements, you get a message that there is nothing to apply it to. That is expected, not an error.

Morphing

Controlling the morph

  • Morph Time: how long a morph takes when you use the container's global timing.
  • Global timing: on, a recalled preset uses the time, curve and distribution stored with it. Off, each element uses its own stored time.
  • Curve: the shape of the move from one value to the next.
  • Pause: holds a running morph where it is.
  • Stop: ends the morph and leaves every value where it was.
  • Blend A/B: slide between two presets by hand. Toggles, menus and whole numbers take preset A's value below the halfway point and preset B's from halfway up.
  • Randomize: sends the elements to random values. Distribution sets how those random values spread.

Each element can also have its own settings. With Multitrack on, an element whose End Mode is loop or pingpong keeps looping after a preset recall.

Menu

The container menu

Right-click empty space inside a container to open its menu.

  • Reset parameters: puts every element back to the value and range it had when you added it.
  • Clear parameters: removes every element, and their values from every preset. You are asked first.
  • Rename presets in order: renames the presets to match the order of their buttons, for example after an Alt+drag swap.
  • Add script: adds a script element that runs your own code when it is triggered.

A container can also be exported to a file and imported again. If the file names parameters that no longer exist, the import is refused and tells you what is missing. Nothing is lost.

Signals

Making a parameter move on its own

Any element with a slider can drive its parameter continuously, apart from preset morphs. In expert mode, tick an element's sig box to show its signal controls. Untick it to hide them again: your settings are kept.

  • LFO: a repeating wave, such as sine or square.
  • Pattern: a stepped sequence of values. See the next section.
  • Timeline: an envelope that follows the project timeline. Pick Loop to ramp and restart, Bounce to rise and fall, or Once to run one pass and hold.
  • Range: the low and high values the signal moves between.
  • Smoothing: softens the output. Set its amount and length.
  • Free running: the signal runs at its own rate, in Hz.
  • Manual: the signal holds still and moves only when you press Manual Trigger. A pattern steps once, an LFO or timeline restarts.
  • Beat, Bar, Sixteenths: locks the signal to the transport, with a multiplier for each. Needs a transport wired on the Inputs page.
  • Timeline sync: ties the signal to the project timeline, so scrubbing the playhead scrubs the signal. Repetitions sets how many cycles fit across the project. A timeline signal runs over the whole project, or over its own Duration in seconds when set to Custom.
Patterns

Pattern types

Pick a pattern type, then type its values. Each type keeps its own values, so you can switch types and back without losing anything.

  • Pseq: plays the sequence in order, looping.
  • Prand: picks from the sequence at random.
  • Pxrand: picks at random, never the same value twice in a row.
  • Pshuffle: shuffles the sequence once, then loops it.
  • Pwrand: picks at random, weighted. Give exactly one weight per value.
  • Pseries: counts up from a start in even steps, then repeats.
  • Pgeom: grows from a start by a factor each step, then repeats.
  • Pwhite: random values between a low and a high.
  • Pbrown: wanders between a low and a high in small steps.
Type a sequence with spaces, commas, semicolons or brackets: 0.1, 0.5, 1 and 0.1 0.5 1 both work. Anything that is not a number is refused with a message.
MIDI and OSC

Controlling it from hardware

Wire a MIDI or OSC CHOP into Midi or Osc on the Inputs page. The Map icon (a crosshairs) then shows in the header.

Do thisTo
Click Map in the header

Show a badge on every control you can map. Mapped controls look different from free ones.

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 the same hardware again moves the mapping instead of adding a second one.

Pulse Manage Mappings on the Mappings page

See every mapping in one list. Set each one's Min and Max, and jump or pickup.

Prune Dead Mappings

Remove rows marked *(missing)*, whose control is gone.

Pulse Clear Mappings

Remove all mappings.

  • jump: the parameter follows the hardware at once. This is the default.
  • pickup: waits until the hardware reaches the parameter's current value, then takes over, so nothing jumps.

A parameter driven by an expression or an export cannot be mapped, and the panel tells you which one it is. Wire a transport into Transport to sync signals to the beat and show the BPM in the header.

Tools

Companion tools

The menu in the header builds extra tools that work with your containers: Timers, Channels, Grabber, Animator and Patterns.

  • Timers: the morph timers of each container, as channels.
  • Channels: one channel per element, holding its value, named after the container and the parameter.
  • Animator: the Preset Animator. Pulse Create Animation to build its animation the first time.
Look

Colours and skins

Do thisTo
Right-click an element's colour chip

Pick a colour for it. It shows as a stripe down the element.

  • Palette: sixteen colours drawn from the skin's accent, plus white, grey, dark and black for marking something as uncoloured.
  • Skin: Carbon (the default), Verdigris or Mono. Set it with Skin on the Look component inside Parameter Morpher. It colours the whole panel.
  • Element colouring: turn it off on the same Look component to hide the stripes and the picker. Your colours are kept.