OSC: Add documentation for the GUI.
This commit is contained in:
parent
4d088a8db6
commit
95ce8f20a9
@ -69,6 +69,18 @@ here</em>"/></kbd>
|
|||||||
strip's controls are sent (or refreshed) as well. This will also
|
strip's controls are sent (or refreshed) as well. This will also
|
||||||
refresh the Master feedback setup.
|
refresh the Master feedback setup.
|
||||||
</p>
|
</p>
|
||||||
|
<p class="note">
|
||||||
|
Surface Port Setting is available in the OSC GUI.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
As of Ardour 5.1, There is now a GUI setup in response to those using
|
||||||
|
tablets with applications such as touchOSC or AndrOSC who need to be
|
||||||
|
able to set a port for Ardour to send to. It can also change the
|
||||||
|
default setting for set_surface. For more information about Ardour's
|
||||||
|
OSC configuration GUI please read <a
|
||||||
|
href="/using-control-surfaces/controlling-ardour-with-osc/osc-setup-dialog/">
|
||||||
|
Ardour's Setup Dialog.</a>
|
||||||
|
</p>
|
||||||
<p>If /set_surface is not sent, the default values are used:
|
<p>If /set_surface is not sent, the default values are used:
|
||||||
<ul>
|
<ul>
|
||||||
<li><em>Bank Size</em>: 0 - No banking (or infinite bank size).</li>
|
<li><em>Bank Size</em>: 0 - No banking (or infinite bank size).</li>
|
||||||
|
@ -65,6 +65,10 @@ title: OSC Feedback With Ardour
|
|||||||
See strip section below for info about ssid and wrapping it into the
|
See strip section below for info about ssid and wrapping it into the
|
||||||
path. Also /master and /monitor support what the /strip does.
|
path. Also /master and /monitor support what the /strip does.
|
||||||
</p>
|
</p>
|
||||||
|
<p>
|
||||||
|
In the case where Gainmode is set to position, the track name will
|
||||||
|
show the dB value while values are changing.
|
||||||
|
</p>
|
||||||
<dl class="bindings">
|
<dl class="bindings">
|
||||||
<dt><kbd class="osc">/strip/name <em>ssid</em> <em>track_name</em></kbd></dt>
|
<dt><kbd class="osc">/strip/name <em>ssid</em> <em>track_name</em></kbd></dt>
|
||||||
<dd>where <em>track_name</em> is a string representing the name of the track</dd>
|
<dd>where <em>track_name</em> is a string representing the name of the track</dd>
|
||||||
|
@ -99,7 +99,7 @@ title: Calculating Feedback and Strip-types Values
|
|||||||
64 - Send timecode.
|
64 - Send timecode.
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
128 - Send meter as dB (-193 to +6) or 1024 depending on gainmode
|
128 - Send meter as dB (-193 to +6) or 0 to 1 depending on gainmode
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
256 - Send meter a 16 bit value where each bit is a level
|
256 - Send meter a 16 bit value where each bit is a level
|
||||||
@ -115,6 +115,9 @@ title: Calculating Feedback and Strip-types Values
|
|||||||
<li>
|
<li>
|
||||||
2048 - Send position in time, hours, minutes, seconds and milliseconds
|
2048 - Send position in time, hours, minutes, seconds and milliseconds
|
||||||
</li>
|
</li>
|
||||||
|
<li>
|
||||||
|
8192 - Turn on extra select channel feedback beyond what a /strip supports
|
||||||
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
<p>
|
<p>
|
||||||
So using a value of 19 would turn on feedback for strip and master
|
So using a value of 19 would turn on feedback for strip and master
|
||||||
|
@ -0,0 +1,113 @@
|
|||||||
|
---
|
||||||
|
layout: default
|
||||||
|
title: Using the OSC Setup Dialog
|
||||||
|
---
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Starting with Ardour 5.1 OSC has a graphic setup dialog. This dialog
|
||||||
|
can be accessed from Preferences->Control Surfaces. Select OSC and
|
||||||
|
click on the Show Protocol Settings.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
The Ardour OSC dialog has three tabs. The main tab, the Strip Types
|
||||||
|
tab and the Feedback tab.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
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 a /set_surface* 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. The <em>Clear OSC Devices</em> will reset all
|
||||||
|
device settings. A <em>/refresh</em> message will both reset the
|
||||||
|
device settings as well as set that device to any new settings. The
|
||||||
|
Use of <em>/set_surface</em> will override all settings except
|
||||||
|
<em>Port Mode</em>.
|
||||||
|
</p>
|
||||||
|
<h2>Dialog settings</h2>
|
||||||
|
<h3>OSC setup tab</h3>
|
||||||
|
<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.
|
||||||
|
</p>
|
||||||
|
<h4>Port Mode:</h4>
|
||||||
|
<p>
|
||||||
|
This drop down allows the choice of Auto or Manual outbound port
|
||||||
|
setting. The default Auto port mode, will send OSC messages back to
|
||||||
|
the port messages from that surface are received from. This setting
|
||||||
|
allows two surfaces on the same IP to operate independently. However,
|
||||||
|
there are a number of OSC control surfaces that do not monitor the
|
||||||
|
same port they send from and in fact may change ports they send from
|
||||||
|
as well. Manual allows the outgoing port (the port the surface will
|
||||||
|
receive on, to be manually set. In Manual port mode only one control
|
||||||
|
surface per IP can work. Most phone or tablet OSC controllers like
|
||||||
|
touchOSC or Control need Manual port mode. More than one controller
|
||||||
|
can be used so long as each has it's own IP.
|
||||||
|
</p>
|
||||||
|
<h4>Manual Port:</h4>
|
||||||
|
<p>
|
||||||
|
This is an Entry box for setting the outgoing port when in
|
||||||
|
Manual port mode.
|
||||||
|
</p>
|
||||||
|
<h4>Bank Size:</h4>
|
||||||
|
<p>
|
||||||
|
This sets the default bank size for the next surface to send a
|
||||||
|
<em>/set_surface/*</em> OSC message. Bank size 0 (the default) sets
|
||||||
|
no banking and allows controlling all strips included in strip_types
|
||||||
|
at once.
|
||||||
|
</p>
|
||||||
|
<h4>Gain Mode:</h4>
|
||||||
|
<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
|
||||||
|
/*/name feedback for the channel will show dB values in text while the
|
||||||
|
fader is being adjusted and then return the the name text.
|
||||||
|
</p>
|
||||||
|
<h4>Debug:</h4>
|
||||||
|
<p>
|
||||||
|
For debugging purposes this allows logging either good OSC messages
|
||||||
|
Ardour receives or invalid messages received or none.
|
||||||
|
</p>
|
||||||
|
<h4>Preset:</h4>
|
||||||
|
<p>
|
||||||
|
Ardour now allows the use of preset settings. The default settings
|
||||||
|
used are the settings from the last session or the factory defaults
|
||||||
|
the first time OSC is enabled. As soon as any of these settings are
|
||||||
|
changed, the Preset will change to "User" and the new settings will be
|
||||||
|
save to the osc directory Ardour configuration directory as
|
||||||
|
<em>user.preset</em>. This preset file can be renamed for future use.
|
||||||
|
It is suggested to also change the name value inside to avoid confusion
|
||||||
|
in the preset listing. Ardour will ship with some of it's own presets
|
||||||
|
that go with some popular OSC control and map combinations.
|
||||||
|
</p>
|
||||||
|
<h4>Clear OSC Devices</h4>
|
||||||
|
<p>
|
||||||
|
This button clears operating device profiles so that Ardour will reset
|
||||||
|
all devices settings to use the new defaults from changed settings. a
|
||||||
|
device may still override these new settings with the /set_surface set
|
||||||
|
of commands. The reason for setting defaults settings is that some OSC
|
||||||
|
controllers are not able to send more than one parameter at a time and
|
||||||
|
so having correct defaults allows one "Connect" button rather than 4.
|
||||||
|
</p>
|
||||||
|
<h3>Default Strip Types tab</h3>
|
||||||
|
<p>
|
||||||
|
This allows selecting which of Ardour's mixer strips will be available
|
||||||
|
for control. The Factory default is all strips except master, monitor
|
||||||
|
and hidden strips. If it is desired to only see input tracks the
|
||||||
|
others can be deselected. It is also possible to change these settings
|
||||||
|
from the control surface. A set of buttons could select showing only
|
||||||
|
inputs or only buses. If a group is selected in the GUI then showing
|
||||||
|
only selected strips will show only that group. Showing hidden tracks
|
||||||
|
is handy for cases where a groups of tracks that grouped to a bus or
|
||||||
|
controlled by a VCA are hidden, but one of those tracks needs a tweak.
|
||||||
|
</p>
|
||||||
|
<h3>Default Feedback tab</h3>
|
||||||
|
<p>
|
||||||
|
This allows setting up which controls provide feedback. The Factory
|
||||||
|
default is none. If the controller is unable to receive feedback, this
|
||||||
|
should be left blank. In the case of metering, Metering as a LED strip
|
||||||
|
only works if Metering as a Float is disabled.
|
||||||
|
</p>
|
@ -174,6 +174,8 @@ bindings">
|
|||||||
The <code>sysex=</code> and <code>msg=</code> bindings will only work with
|
The <code>sysex=</code> and <code>msg=</code> bindings will only work with
|
||||||
<code>function=</code> or <code>action=</code> control addresses. They
|
<code>function=</code> or <code>action=</code> control addresses. They
|
||||||
will <em>not</em> work with the <code>uri=</code> control addresses.
|
will <em>not</em> work with the <code>uri=</code> control addresses.
|
||||||
|
Controls used with <code>uri=</code> require a <em>Value</em> which is
|
||||||
|
only available in a known place with channel mode MIDI events.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<h4>Control address</h4>
|
<h4>Control address</h4>
|
||||||
|
Loading…
Reference in New Issue
Block a user