ardour/manual
13
0
Fork 0
Code Pull Requests Releases Activity

try to explain the connection and difference between function and action bindings in a binding map

Browse Source
This commit is contained in:
Paul Davis 2020-08-17 13:18:47 -06:00
parent 9221af9b1d
commit 838f726821
1 changed files with 21 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
include/generic-midi-binding-maps.html
View File

@ -102,16 +102,18 @@ bindings">
<p>
There are two basic kinds of bindings you can make between a MIDI message
and something inside Ardour. The first is a binding to a specific parameter
of a track or bus. The second is a binding to a function that will change
Ardour's state in some way.
of a track or bus. The second is a binding to something that will change
Ardour's state in some way (the "something" could either be called a
function or an action, see below).
</p>
<h4>Binding to Track/Bus controls</h4>
<p>
A track/bus binding has one of two basic structures
A track/bus binding has one of three basic structures
</p>
<code>
&lt;Binding <em>msg specification</em> uri="<em>&hellip; control address &hellip;</em>"/&gt;</br>
&lt;Binding <em>msg specification</em> function="<em>&hellip; function name &hellip;</em>"/&gt;
&lt;Binding <em>msg specification</em> action="<em>&hellip; action name &hellip;</em>"/&gt;
</code>
<h4>Message specifications</h4>
@ -283,16 +285,25 @@ bindings"&gt;
There is currently no feedback available for functions.
</p>
<p>
Rather than binding to a specific track/bus control, it may be useful to
have a MIDI controller able to alter some part of Ardour's state. A
binding definition that does this looks like this:
Rather than binding to a specific track/bus/plugin control, it may be useful to
have a MIDI controller able to alter some part of Ardour's
state. Ardour's Generic MIDI support provides a small number of
easily-used "functions" to do the most common operations, using a
binding that looks like this:
</p>
<code>
&lt;Binding channel="1" note="13" function="transport-roll"/&gt;
</code>
<p>
In this case, a NoteOn message for note number 13 (on channel 1) will
start the transport rolling. The following function names are available:
start the transport rolling.
</p>
<p>
Note that a much greater number of operations are possible using
actions, described below.
</p>
<p>
The following function names are available:
</p>
<table class="dl">
<tr><th>