User Manual
Trigger Editor
Arrr, a MIDI trigger be connectin' an incomin' MIDI message — from a foot controller, expression pedal, or control surface — t' an action in OnSong, so yer hardware can drive th' app hands-free, savvy? Th' screen here be settin' up a single trigger. Yer changes be savin' as ye make 'em, so just tap Done when ye be finished, matey.
Which options appear be dependin' on th' kind o' controller ye be mappin', but every trigger be startin' with these two, Blimey!:
MIDI Event
A MIDI Event be th' incomin' message that fires th' trigger — a note, a control change (CC), and so on, Ahoy! Tap t' choose th' message and its channel; th' row be showin' yer choice, like "CC 4 on Channel 1."
Action
Th' Action be what OnSong be doin' when th' trigger fires, ye scallywag. Tap t' pick from th' action chooser; th' row be showin' th' assigned action, or "Unassigned." For a variable control change like an expression pedal or knob that be sendin' a smooth 0–127 sweep, ye'll also be seein':
Response Curve
Th' Response Curve be shapin' how th' controller's travel be mappin' t' th' action, Arrr!
- Linear — th' controller and th' parameter be movin' together, 1:1.
- Logarithmic — most o' th' travel be workin' at th' quiet end; grand fer a natural volume feel.
- Exponential — most o' th' travel be subtle, and th' top o' th' range be pushin' hard.
- S-Curve — stable at th' extremes and fast through th' middle; good fer crossfades.
Minimum and Maximum Value
These be clamplin' th' input event useful range within 0–127, savvy? Anythin' outside th' range be ignored, so ye can dial in exactly th' sweep ye want. Th' minimum always be stayin' below th' maximum.
For a momentary control, like a button or switch sendin' a CC, ye'll be seein' these instead, Blimey!:
Behavior
Behavior be decidin' how presses be mappin' t' th' action, matey. Tap th' row t' cycle through:
- Momentary — active once a value greater than 0 be received
- Latch — fires th' action on both edges, but with no on/off value. Press be firin' it once, release be firin' it again, each just a plain action. Use it when yer controller be sendin' a separate press and release message and ye want th' action t' respond t' both.
- Toggle — be treatin' th' action as an on/off state. Crossin' th' threshold on th' way up be sendin' th' "On" action while droppin' back below be sendin' th' "Off" action. Use this fer anythin' with a held state like a mute, a hold, a light.
Threshold
This be th' value at or above which th' controller be countin' as on, Arrr! Values below it be ignored. It be defaultin' t' 1 fer Momentary and 64 fer Toggle.
Inverted
This settin' be reversin' th' input value direction. 0 becomes 127 and vice versa, savvy? Handy when a pedal be mounted or wired backwards.
Active
This be turnin' th' trigger on or off, ye scallywag. Switch it off t' suspend th' trigger without deletin' th' bindin', so ye can be bringin' it back later, Ahoy!