X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgeneric-midi-binding-maps.html;h=f7d6ad515a2f57086f29c3ecd4da75d8b1675610;hb=838f7268217de24d10c4462936250963bb84472e;hp=e9117296e64669f2d0400b03f6b06863527d9524;hpb=11ed38e04a82d0ebb0784c19fafc714095208624;p=ardour-manual diff --git a/include/generic-midi-binding-maps.html b/include/generic-midi-binding-maps.html index e911729..f7d6ad5 100644 --- a/include/generic-midi-binding-maps.html +++ b/include/generic-midi-binding-maps.html @@ -14,28 +14,36 @@ Currently (August 2016), we have presets for the following devices/modes:
- On OS X, Ardour loads midi maps from its binary-bundle folder in
- Ardour-<version>/midi_maps/
and checks
- various other locations as well (defined by the ARDOUR_MIDIMAPS_PATH
- environment variable). On GNU/Linux the easiest is to save the file to
- ~/.config/ardour3/midi_maps/
.
+ The file should be located in the midi_maps sub directory located in
+ the Ardour configuration directory
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).
- A track/bus binding has one of two basic structures + A track/bus binding has one of three basic structures
- <Binding msg specification uri="… control address …"/>
+ <Binding msg specification uri="… control address …"/>
<Binding msg specification function="… function name …"/>
+ <Binding msg specification action="… action name …"/>
- <Binding channel="1" ctl="13" ….
+ <Binding channel="1" ctl="13" …
This defines a binding for a MIDI Continuous Controller message involving
@@ -125,6 +132,29 @@ bindings">
use note
(to create binding for a Note On message) or
pgm
(to create a binding for a Program Change message).
+ Continous Controlers (CCs) have coninued to evolve for different controlers. + The use of Encoders, RPN, NRPN, and controller buttons that give a 0 value + when released instead of toggling are now supported. These all have their + own type. The whole list of CC types are: +
++
note
with the momentary
parameter set)note
)
As of Ardour 4.2, enc-r
, enc-l
, enc-2
and
enc-b
may be used for surfaces that have encoders that send
@@ -135,11 +165,26 @@ bindings">
Learn more about working with encoders
)
+
<Binding channel="1" enc-r="13" …
<Binding channel="1" enc-l="13" …
<Binding channel="1" enc-2="13" …
<Binding channel="1" enc-b="13" …
enc-*
value is the CC number used by the encoder.
+ Encoders only work with CC messages.
+
++ Ardour 5.12 has a bug with the encoder detection where the first + encoder message resets the control to 0. Setting "Enable Feedback" + on allows encoders to work as expected. +
You can also bind sysex messages:
- <Binding sysex="f0 0 0 e 9 0 5b f7" ….
+ <Binding sysex="f0 0 0 e 9 0 5b f7" ….
<Binding sysex="f0 7f 0 6 7 f7" ….
@@ -149,7 +194,7 @@ bindings">
Finally, you can bind a totally arbitrary MIDI message:
- <Binding msg="f0 0 0 e 9 0 5b f7" ….
+ <Binding msg="f0 0 0 e 9 0 5b f7" ….
<Binding msg="80 60 40" ….
@@ -177,6 +222,9 @@ bindings"> A control address defines what the binding will actually control. There are quite a few different things that can be specified here:
++ Enable Feeback applies to these "Control Addresses" only. +
/route/gain | the gain control ("fader") for the track/bus |
---|
Each of the specifications needs an address, which takes various forms too. For track-level controls (solo/gain/mute/recenable), the address is one the following:
a number, eg. "1" + | |
---|---|
a number, e.g. "1" | identifies a track or bus by its remote control ID |
@@ -299,10 +359,14 @@ bindings"> |
---|
+ It is not possible to have feedback available for actions because + these represent keyboard shortcuts which are input only. +
You can also bind a sysex or arbitrary message to any of the items that occur in Ardour's main menu (and its submenus). The + href="@@list-of-menu-actions"> list of actions shows all available values of action-name.
To create a binding between an arbitrary MIDI message (we'll use a @@ -370,6 +434,9 @@ bindings"> <Binding channel="1" note="15" uri="/route/mute B1" momentary="yes"/> <Binding channel="1" note="16" uri="/route/mute B2" momentary="yes"/> + <Binding channel="1" enc-r="11" uri="/route/pandirection B1"/> + <Binding channel="1" enc-r="12" uri="/route/pandirection B2"/> + <Binding sysex="f0 0 0 e 9 0 5b f7" function="transport-start"/> <Binding sysex="f0 7f 0 6 7 f7" function="rec-disable"/> <Binding sysex="f0 7f 0 6 6 f7" function="rec-enable"/> @@ -387,3 +454,4 @@ bindings"> decimal numbers in the ranges 1-16, 0-127 and 0-127 respectively (the channel range may change at some point).
+