X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgeneric-midi-binding-maps.html;h=144e2e9e2e31978d3730dc237a09e45aa58b9d0f;hb=04489f8e64aa992614d522e7760a484765d40b7f;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..144e2e9 100644 --- a/include/generic-midi-binding-maps.html +++ b/include/generic-midi-binding-maps.html @@ -73,11 +73,8 @@ bindings"> So, to start, create a file with that as the initial contents.

- 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

Finding out what your MIDI control surface sends

@@ -116,7 +113,7 @@ bindings"> like this:

- <Binding channel="1" ctl="13" …. + <Binding channel="1" ctl="13" …

This defines a binding for a MIDI Continuous Controller message involving @@ -135,6 +132,21 @@ bindings"> Learn more about working with encoders )

+

+

+ The 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:

@@ -177,6 +189,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. +

@@ -200,7 +215,7 @@ bindings">
/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:

- @@ -233,6 +248,9 @@ bindings">

Bindings to Ardour "functions"

+

+ There is currently no feedback available for functions. +

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 @@ -299,10 +317,14 @@ bindings">

a number, eg. "1" +
a number, e.g. "1" identifies a track or bus by its remote control ID

Binding to Ardour "actions"

+

+ 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 +392,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 +412,4 @@ bindings"> decimal numbers in the ranges 1-16, 0-127 and 0-127 respectively (the channel range may change at some point).

+