Many OSC devices get their IP from a DHCP making it difficult to set
an IP in Ardour's OSC settings. Therefore, most of the settings are
<em>default</em> settings. Values are set and the next OSC surface to
- send an OSC message to Ardour will use those settings. An OSC
- surface that has previously sent a message to Ardour will retain the
- settings it already had. Any change to a setting will reset all
- device settings. A <em>/refresh</em> message will set that device to
- any new settings. The use of <em>/set_surface</em> will override all
+ send an OSC message to Ardour will use those settings. Any change to a
+ setting will reset all
+ device settings. The use of <em>/set_surface</em> will override all
settings except <em>Port Mode</em>. <em>Port Mode</em> affects all
connected surfaces and so all surfaces must use either the set manual
port or send OSC messages from the same port they expect to receive
</p>
<h2>Dialog settings</h2>
<h3>OSC setup tab</h3>
-<p>
-<img alt="the OSC configuration dialog"
- src="/images/osc-dialog.png">
-</p>
+
+<figure>
+ <img alt="The OSC configuration dialog" src="/images/osc-dialog.png">
+ <figcaption>
+ The OSC configuration dialog
+ </figcaption>
+</figure>
+
<h4>Connection:</h4>
<p>
This field is informational only. It shows where Ardour will receive
OSC messages. The system Name and the Port are the most important parts.
- Normally, Ardour will use 3819 as it's server port. However, if some
+ Normally, Ardour will use 3819 as its server port. However, if some
other server is already using this port, Ardour will try to use the next
port up and will keep trying up to 10 ports up.
</p>
<h4>Port Mode:</h4>
-<p>
-<img alt="Port Mode Dropdown"
- src="/images/osc-portmode.png">
-</p>
+
+<figure>
+ <img alt="Port Mode Dropdown" src="/images/osc-portmode.png">
+ <figcaption>
+ Port Mode Dropdown
+ </figcaption>
+</figure>
+
<p>
This drop down allows the choice of Auto or Manual outbound port
setting. The Auto port mode, will send OSC messages back to
controllable.
</p>
<h4>Gain Mode:</h4>
-<p>
-<img alt="Gain Mode Dropdown"
- src="/images/osc-gainmode.png">
-</p>
+
+<figure>
+ <img alt="Gain Mode Dropdown" src="/images/osc-gainmode.png">
+ <figcaption>
+ Gain Mode Dropdown
+ </figcaption>
+</figure>
+
<p>
Sets the faders (and sends faders) feedback math to position where a
value between 0 and 1 represents the fader position of the same fader
in the mixer GUI or dB where the feedback from fader movement will be
- returned as a dB value. When the Gain Mode is set to position, the
+ returned as a dB value. When the Gain Mode is set to position, there
+ are also options to send the gain in dB either to the channel name,
/*/name feedback for the channel will show dB values in text while the
- fader is being adjusted and then return the name text.
+ fader is being adjusted and then return the name text. It can also be
+ set to send both position and gain or just position.
</p>
<h4>Debug:</h4>
-<p>
-<img alt="Debug Mode Dropdown"
- src="/images/osc-debug.png">
-</p>
+
+<figure>
+ <img alt="Debug Mode Dropdown" src="/images/osc-debug.png">
+ <figcaption>
+ Debug Mode Dropdown
+ </figcaption>
+</figure>
+
<p>
For debugging purposes this allows logging either all OSC messages
- Ardour receives or invalid messages received or none.
+ Ardour receives or invalid messages received or none. The last option:
+ <kbd class="menu">Print surface information to Log window</kbd> prints
+ the internal information that Ardour uses to create feedback for all
+ surfaces Ardour knows about.
</p>
<h4>Preset:</h4>
-<p>
-<img alt="Preset Loader"
- src="/images/osc-preset.png">
-</p>
+
+<figure>
+ <img alt="Preset Loader" src="/images/osc-preset.png">
+ <figcaption>
+ Preset Loader
+ </figcaption>
+</figure>
+
<p>
Ardour now allows the use of preset settings. The default settings
used are the settings from the last session or the factory defaults
so having correct defaults allows one "Connect" button rather than 4.
</p>
<h3>Default Strip Types tab</h3>
-<p>
-<img alt="the Default Strip Types tab"
- src="/images/osc-strip-types.png">
-</p>
+
+<figure>
+ <img alt="The Default Strip Types tab" src="/images/osc-strip-types.png">
+ <figcaption>
+ The Default Strip Types tab
+ </figcaption>
+</figure>
+
<p>
This allows selecting which of Ardour's mixer strips will be available
for control. The Factory default is all strips except master, monitor
controlled by a VCA are hidden, but one of those tracks needs a tweak.
</p>
<h3>Default Feedback tab</h3>
-<p>
-<img alt="the Default Feedback tab"
- src="/images/osc-feedbackdefault.png">
-</p>
+
+<figure>
+ <img alt="The Default Feedback tab" src="/images/osc-feedbackdefault.png">
+ <figcaption>
+ The Default Feedback tab
+ </figcaption>
+</figure>
+
<p>
This allows setting up which controls provide feedback. The Factory
default is none. If the controller is unable to receive feedback, this