Toggle
The Toggle is a two-state switch, On and Off. It works in MIDI, MACRO or OSC mode.
What it's for
- MIDI: turn on effects, mute, sustain (CC 64) or any on/off parameter.
- OSC: trigger scenes, layers or effects in software over the network.
- MACRO: move several controls from a state A to a state B with a single tap. For example, a "chorus mode" that raises the reverb, opens a filter, turns on a pad and changes the chord of the Drone Pad.
Adding a toggle
- Open the Editor.
- In the palette, choose Toggle in the MIDI, MACRO or OSC section.
- Double-tap the control to open the inspector.
- Choose the behavior and the values for the mode, then tap Save.
Using it in Perform
Tap it. What happens depends on BEHAVIOR:
- Toggle (default): each tap switches between On and Off.
- Momentary: it stays On only while you hold it down.
Inspector options
| Section | Option | Values |
|---|---|---|
| MODE | MIDI · MACRO · OSC | |
| INSTANCE NAME | Text | |
| BEHAVIOR | Momentary / Toggle | Default: Toggle |
| MIDI | Channel / CC | 1–16 / 0–127 |
| MIDI | On Value / Off Value | 0–127 (defaults 127 / 0) |
| OSC | Output, Path, Custom Path | See MIDI and OSC connections |
| OSC | On Value / Off Value | Decimal number, sent as FLOAT (defaults 1.0 / 0.0) |
| MACRO | Targets | See below |
| MACRO | Duration | 0–5 s in 0.1 s steps; 0 = Instant |
| CLIPBOARD | COPY / PASTE | |
| APPEARANCE | Use Global Color / Custom Color |
Macro mode
In Macro mode, the toggle defines two complete states of your surface: what happens at Off and what happens at On. When you tap it, all its targets change together.
| Target | What you set |
|---|---|
| Fader or Knob (not Macro) | Value at Off and value at On (0–127, or the target's OSC range) |
| XY Pad | Values at Off and at On for each axis, X and Y |
| Toggle (not Macro) | State at Off and at On |
| Pad in Toggle mode | State at Off and at On |
| Drone Pad | Active root notes at Off and at On |
- Targets can be on any page of the scene.
- Duration controls the transition between Off and On for continuous targets (Fader, Knob and XY Pad). At 0 the change is instant; with higher values, the controls glide to their new value over that time, up to 5 seconds.
More on the modes in MIDI, MACRO and OSC modes. To recall the state of many controls with more options, see also State.
Limits
- The toggle's OSC value is always sent as FLOAT.
- A toggle in Macro mode can't be the target of another toggle in Macro mode.
- The OSC Output and Path you set in the Page Inspector don't apply to the toggle; set them in its own inspector.
Grid size on iPhone and iPad
In cells (width × height):
| Device | Minimum | When created | Maximum |
|---|---|---|---|
| iPhone | 4×2 | 6×2 | 16×6 |
| iPad | 3×1 | 4×2 | 12×9 |