TDXMorph4

Preset Snap1.3

Store and recall parameter snapshotsReal-time composition, enhanced

Save how your component's parameters are set right now, and snap straight back to it whenever you want. This page shows how to set it up, store and recall presets, and choose what gets saved.

Setup

Getting started

Drop PresetSnap.tox into the component whose parameters you want to save. A new Presets page appears on that component. That page is where all the controls live.

There is nothing to set up: every custom parameter on the component is saved by default.

Presets

Storing and recalling

Everything happens on the Presets page of the component you dropped Preset Snap into.

Do thisTo
Type in Preset name

Give a name to the next preset you make or rename. You can leave it empty.

Pulse New Preset

Make a new preset from your parameters as they are now. With no name typed, it is named for you, like Preset 3.

Pick from the Preset menu

Recall that preset. The values snap back straight away.

Pulse Store

Replace the selected preset with your parameters as they are now. If no preset is selected, it makes a new one.

Pulse Rename

Rename the selected preset to what you typed in Preset name.

Pulse Delete

Delete the selected preset. It asks you first, and names the preset.

Store has no confirmation and no undo. It overwrites the selected preset completely.

After New Preset or Rename uses your typed name, the field clears itself, so a name never lands on the wrong preset by accident.

Live

Playing it from a controller

Every control on the Presets page is a normal parameter, so you can map it to MIDI or OSC. It works with no window open.

  • New Preset: a mapped button always works without stopping you, because an empty name is filled in for you.
  • Preset: changing the menu recalls, so there is no separate Recall button to map.
Editor

Choosing what gets saved

Pulse Edit Params to open the parameter editor in its own window. It lists every parameter Preset Snap saves, with its mode next to it.

Do thisTo
Turn a parameter off in the editor

Leave it out of storing and recalling.

Drag an operator from inside your component onto the editor

Add its parameters too. You get the ones you have already changed from their default, named like noise1.period.

An operator from outside your component is refused, because it would break as soon as you copy your component somewhere else.

Recall

What a recall leaves alone

When you pick a preset, the status bar tells you what happened, for example A: set 5, 2 kept, 1 failed, 1 gone.

  • set: values that were written back.
  • kept: parameters running an expression, export or bind. A recall never touches them, so your expression is never frozen into a number. Remove the expression and the parameter is recalled again.
  • failed: values that would not apply.
  • gone: parameters that were renamed or deleted. They stay in the list with their saved values, in case they come back.

Parameters you turned off, and presets that never saved a value for a parameter, are skipped too.

Limits

What is never saved

  • The Presets page itself: the controls Preset Snap adds are never part of a preset.
  • Pulse and momentary buttons: they have no value to save.
  • How many blocks a sequence has: the values inside each block are saved, but not the count.
  • Anything inside Preset Snap: only your component's parameters count.
If your component is a clone, Preset Snap will not add its page, and says so on the status bar. Put it in the clone master instead.
Component

Preset Snap's own page

Preset Snap has a few controls of its own, on the component itself. Note that deleting Preset Snap does not remove the Presets page from your component, so take the page off first.

Do thisTo
Pulse Remove Page on Preset Snap

Take the Presets page off your component. Do this before you delete it.

Turn Inject Page off on Preset Snap

Same as Remove Page. Turn it back on to bring the page back.

Pulse Rescan on Preset Snap

Look again for new parameters on your component and add them.

Pulse Attach Page on Preset Snap

Set the page up again by hand.

If your component already has its own page called Presets, the controls go onto it. Your own parameters there are saved like any others, and removing takes off only Preset Snap's controls.