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.
Containers
A container holds a group of parameters and its own presets. You can have as many as you like.
Add a new container. Click again for another one.
Rename it.
Place containers side by side instead of stacked.
Show one container at a time, at full height.
Step to the previous or next container. They stop at the first and last one.
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.
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.
Add one element for it. Works for any parameter, built in or custom.
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.
Put it back to the value and range it had when you added it.
Rename it.
Swap their places.
Deleting an element also removes its values from every preset. You are asked first, and told how many presets that touches.
Storing and recalling presets
Each container has its own row of preset slots. Store at least two presets to see a morph.
Store the current value of every element in that container. On a stored slot, it overwrites it.
Morph to that preset, over its own stored time and curve.
Jump straight to the preset, with no morph.
Morph over the container's Morph Time instead of the preset's own time. Handy for a quick check.
Delete the preset.
Freeze or unfreeze the elements, so they cannot be nudged by accident.
Swap which preset each button plays.
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.
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.
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.
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.
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.
Show a badge on every control you can map. Mapped controls look different from free ones.
Arm that control. Its badge blinks while it listens. Click again to disarm.
Bind it to the armed control. Learning the same hardware again moves the mapping instead of adding a second one.
See every mapping in one list. Set each one's Min and Max, and jump or pickup.
Remove rows marked *(missing)*, whose control is gone.
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.
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.
Colours and skins
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.