Proper "touch" automation

[p0nce]

"Touch" automation works for knobs and sliders but not press buttons. It makes erratic moves instead of cleanly reverting to automation start point.

I think this is because in a mouse gesture, the beginParamEdit/endParamEdit must match the click and unclick, which is not the case for every widget. Easy to see with Inner Pitch Full, automating press buttons there. Can repro in a DAW with so-called touch automation, such as Luna, Logic, Protools...

• [ ] Increase the documentation
  • [ ] of beginParamEdit / endParamEdit
  • [ ] of onStopDrag
  • [ ] of onMouseClick (warn about new clicks coming)
• [x] Solve that problem wherever it happens in examples

Interestingly, this is finally an explanation for why should beginParamEdit and endParamEdit need to exist.

[p0nce]

• [x] Big question: is the gesture that start with a double click or ALT + click (reset) is the same gesture in touch automation with the following widget drag? Need to take a decision on this based upon best practice. ANSWER: yes, but most host can deal with double-click and ALT terminating the param edit before start a new param edit. Where is doesn't work is with FlatSwitch and such widgets.

List of incorrect widgets:

• [x] Flat Knob in case of double click, should not initiate a drag operation. If it does, stay in same "param edit" scope. => EDIT no need to deal with that
• [x] Same for PBR Knob => EDIT no need to deal with that
• [x] Same for PBR Slider => EDIT no need to deal with that
• [x] Same for Flat Slider => EDIT no need to deal with that
• [x] Fix UIImageSwitch
• [x] Fix UIOnOffSwitch
• [ ] Anything that isn't working in Studio One / REAPER / Bitwig in touch automation, but that is more in the Auburn plug-ins.

Yeah. Almost all widgets are wrong but this doesn't break user sessions thankfully, it's just quite dangerous as a change.

[p0nce]

Studio One has "touch" automation, could be useful to repro.

• [x] no issue with PBR Slider or Knob, double clicks and alt clicks correctly return to original
• [x] no issue with Flat sliders or knobs
• [x] but issue with "Soft vs Hard" switch in Clip It indeed. Return to original while the mouse is still down.

So Studio One is more permissive than Luna with regards to this. Is this common across DAWs? We can expect Luna to handle this maybe.

(EDIT: exact same behaviour in REAPER than Studio One) (EDIT2: mostly same behaviour in Bitwig too, just Switch has different failure mode there)

=> Most host can fusion adjacent periods of beginParamEdit/endParamEdit to deal with what plugins do. Luna just doesn't do it yet. We only need to fix switch-like, radio buttons, push buttons, likely.

[p0nce]

Super-tricky a widget that call beginParamEdit in onMouseClick must deal with right-click coming while a drag is already there. This might produce

• "fixed" switches fall prey to this; must have state enum.
• Knob not affected by this, since beginParamEdit/endParamEdit is called as part of dragging, but a double right-click or ALR + right click would break that. This creates additional beginParamEdit/endParamEdit unfortunately.