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.
Storing and recalling
Everything happens on the Presets page of the component you dropped Preset Snap into.
Give a name to the next preset you make or rename. You can leave it empty.
Make a new preset from your parameters as they are now. With no name typed, it is named for you, like Preset 3.
Recall that preset. The values snap back straight away.
Replace the selected preset with your parameters as they are now. If no preset is selected, it makes a new one.
Rename the selected preset to what you typed in Preset name.
Delete the selected preset. It asks you first, and names the preset.
After New Preset or Rename uses your typed name, the field clears itself, so a name never lands on the wrong preset by accident.
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.
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.
Leave it out of storing and recalling.
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.
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.
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.
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.
Take the Presets page off your component. Do this before you delete it.
Same as Remove Page. Turn it back on to bring the page back.
Look again for new parameters on your component and add them.
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.