If you're using Kontrol S MK2, A or M and OSARA, you can now quickly turn a knob first to report its parameter and value. Subsequent turns will adjust the value.

Author: jcsteh

readme.md

@@ -51,7 +51,9 @@ However, ReaKontrol provides support for this.
 To access them, press the Mixer button on S MK2, or Track button on A/M series keyboards, then press the 4-d encoder.
 You then use the knobs to adjust parameters.
 If you're using a screen reader, you will need to enable OSARA's "Report changes made via control surfaces" setting to have parameter changes reported.
-Note also that touching the knobs will not provide any feedback and you will instead need to turn the knob slightly to have the parameter and value reported.
+Note also that touching a knob will not provide any feedback.
+Instead, you can quickly turn a knob first to report its parameter and value.
+Subsequent turns will adjust the value.
 On S MK2, you can use the page buttons to move through banks of parameters.
 On A and M series keyboards, pulling the 4-d encoder right and left moves through banks instead.
 Use 4-d encoder down and up to switch plugins.

src/niMidi.cpp

@@ -579,6 +579,8 @@ class NiMidiSurface: public BaseSurface {
 	int _lastChangedFxParam = -1;
 	double _lastChangedFxParamValue = 0;
 	FxMap _fxMap;
+	int _suppressFxParam = -1;
+	DWORD _suppressFxParamStartTime = 0;
 
 	void _onTrackBankChange() {
 		if (this->_isUsingMixerForFx()) {
@@ -926,6 +928,38 @@ class NiMidiSurface: public BaseSurface {
 		if (param == -1) {
 			return;
 		}
+		if (osara_outputMessage) {
+			DWORD now = GetTickCount();
+			if (param == this->_suppressFxParam) {
+				constexpr DWORD SUPPRESS_DELAY = 200;
+				if (now - this->_suppressFxParamStartTime < SUPPRESS_DELAY) {
+					// We avoid changing the parameter for a short period so that an OSARA user
+					// can use a quick twist of the knob to report the parameter without
+					// changing it.
+					return;
+				}
+				// Allow the value to be changed now.
+			} else {
+				this->_suppressFxParam = param;
+				this->_suppressFxParamStartTime = now;
+				// When an OSARA user first turns the knob, report the parameter without
+				// changing it.
+				ostringstream s;
+				s << this->_fxMap.getParamName(mp) << " ";
+				double val = TrackFX_GetParamNormalized(this->_lastSelectedTrack,
+					this->_selectedFx, param);
+				char valText[100] = "";
+				TrackFX_FormatParamValueNormalized(this->_lastSelectedTrack,
+					this->_selectedFx, param, val, valText, sizeof(valText));
+				if (valText[0]) {
+					s << valText;
+				} else {
+					s << val;
+				}
+				osara_outputMessage(s.str().c_str());
+				return;
+			}
+		}
 		double val ;
 		if (param == this->_lastChangedFxParam) {
 			// Some parameters snap to defined values when you set them. This means that