From 14511de427194d5f7c1e9deeeef0339f0363b778 Mon Sep 17 00:00:00 2001
From: Len Ovens
Date: Fri, 13 May 2016 14:04:52 -0700
Subject: [PATCH] OSC: Cleaned up spelling, ordering, punctuation and fixed
master section.
---
.../01_controlling-ardour-with-osc.html | 87 +++++++++----------
1 file changed, 43 insertions(+), 44 deletions(-)
diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html
index 59aa90c..d9ff36c 100644
--- a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html
+++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html
@@ -60,22 +60,44 @@ here"/>
to valuse set by Aurdour's GUI or automation, What kind of math the
faders use and more.
+
+ Any time the /set_surface command is sent, the current bank
+ is recalculated and if feedback is turned on, the values of each
+ strip's controls are sent (or refreshed) as well.
+
+If /set_surface is not sent, the default values are used:
+
+ - Bank Size: 0 - No banking (or infinite bank size).
+ - Strip Types: All strip types except hidden.
+ - Feedback: Off.
+ - Fader Mode: ABS - Absolute gain.
+
+ These values give the same behaviour as prior versions of Ardour.
+
- /set_surface bank_size strip_types
feedback fadermode
- - where bank_size is an int ranging from 0 to about 65000
- (16bits) The value 0 means no banking (or infinite bank size).
- strip_types (when implemented) is a bitset that will
- determine what kind of channels will be included in the bank.
- feedback is a bitset that determines what things should send
- feedback to the control surface. fadermode is a string that
- tells Ardour what kind of math the control surface's faders use.
+ -
+ See below for an explaination of each parameter.
+
-
- Strip Types Coming soon... check for more info sometime.
+
bank_size
+
+ Bank Size is the number of channel strips the controller supports
+ without banking. Setting this to 0 turns banking off by setting the
+ bank size to infinite.
-
- Feedback This is an integer made up of bits. The easy way to
+
strip_types
+
+ Strip Types are coming soon... check for more info sometime. For now
+ just use 0 (or anything else) as this is ignored. I don't know the bit
+ order just yet, but it will work similar to feedback below. Strip Types
+ will determine What kind of strips will be included in a bank. This would
+ include: Audio, MIDI, busses, VCAs, Master, Monitor and hopefully
+ hidden or selected strips.
+
+feedback
+ Feedback is an integer made up of bits. The easy way to
deal with this is to think of feedback items being worth a number and
then adding all those numbers together for a value to send.
@@ -94,11 +116,12 @@ here"/>
-
16 - Enable master section feedback (not coded yet).
- So using a value of 17 would turn on feedback for strip and master
- controls, but leave meters, timecode and bar/beat feedback off.
+ So using a value of 17 would turn on feedback for strip and master
+ controls, but leave meters, timecode and bar/beat feedback off.
-
+
gainmode
+
Gainmode is a string that is one of:
- ABS Absolute Gain as a float value from 0.0 to 2.0
@@ -113,19 +136,6 @@ here"/>
0 to 1023 (1024 values) for controllers with no FPU. Sent as
/strip/fader1024 RID value
-
- Any time the /set_surface command is sent, the current bank
- is recalculated and if feedback is turned on, the values of each
- strip's controls are sent (or refreshed) as well.
-
-If /set_surface is not sent, the default values of:
-
- - Bank Size: 0 - No banking (or infinite bank size).
- - Strip Types: All strip types except hidden.
- - Feedback: Off.
- - Fader Mode: ABS - Absolute gain.
-
- These values give the same behaviour as prior versions of Ardour.
List of OSC messages
@@ -133,23 +143,12 @@ here"/>
Master or Global messages
Master and Monitor strip control
+(coming soon)
- - /masterabs abs
- - where abs is a float ranging from 0.0f to 2.0f
- - /masterdB dB
- - where dB is a float ranging from -200f to 6f
- - /masterfader fader
- - where fader is a float ranging from 0.0f to 1.0f
- - /master1024 fader
- - where fader is an int ranging from 0 to 1023
- - /monitorabs abs
- - where abs is a float ranging from 0.0f to 2.0f
- - /monitordB dB
- - where dB is a float ranging from -200f to 6f
- - /monitorfader fader
- - where fader is a float ranging from 0.0f to 1.0f
- - /monitor1024 fader
- - where fader is an int ranging from 0 to 1023
+ - /master/gain value
+ - where value is determined by gainmode. (see /set_surface)
+ - /monitor/gain value
+ - where value is determined by gainmode. (see /set_surface)
Transport Control
@@ -235,7 +234,7 @@ here"/>
where gain_db is a float ranging from -200 to 6 representing the desired gain of the track in dB.
/strip/fader rid fader position
where fader position is a float ranging from 0 to 1 representing the fader control position.
- /strip/gaindB rid gain_db
+ /strip/fader1024 rid fader1024
where fader1024 is an int ranging from 0 to 1023 representing the fader control position.
/strip/trimabs rid trim_abs
where trim_abs is a float ranging from 0.1 to 10 (-20dB to +20dB). (since 4.1)