X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgeneric-midi-binding-maps.html;h=94af9d5a6eacb86ef3b44a05e14d506d82f9e356;hb=88d6f39b5f8b0f791b6833bb1512aa774b59d4f8;hp=cb5f8e2d9c42980c68f4f49a978b9a1f362ae7b3;hpb=3ac2b1ab0af5ff2d380c60cad295cbced589602f;p=ardour-manual diff --git a/include/generic-midi-binding-maps.html b/include/generic-midi-binding-maps.html index cb5f8e2..94af9d5 100644 --- a/include/generic-midi-binding-maps.html +++ b/include/generic-midi-binding-maps.html @@ -53,8 +53,7 @@ remote control ID. This ID uniquely identifies a track or bus so that when messages arrive from elsewhere via MIDI or OSC , we can determine which track or bus they are intended to control. See - + remote control IDs for more information. You just need to know that there is a "first track" and its remote control ID is 1, and so on. @@ -178,46 +177,46 @@ bindings"> A control address defines what the binding will actually control. There are quite a few different things that can be specified here:

-
-
/route/gain
-
the gain control ("fader") for the track/bus
-
/route/trim
-
the trim control for the track/bus (new in 4.1)
-
/route/solo
-
a toggleable control for solo (and listen) of the track/bus
-
/route/mute
-
a toggleable control to mute/unmute the track/bus
-
/route/recenable
-
a toggleable control to record-enable the track
-
/route/panwidth
-
interpreted by the track/bus panner, should control image "width"
-
/route/pandirection
-
interpreted by the track/bus panner, should control image "direction"
-
/route/plugin/parameter
-
the Mth parameter of the Nth plugin of a track/bus -
-
/route/send/gain
-
the gain control ("fader") of the Nth send of a track/bus
-
+ + + + + + + + + + + + + + + + + + + +
/route/gainthe gain control ("fader") for the track/bus
/route/trimthe trim control for the track/bus (new in 4.1)
/route/soloa toggleable control for solo (and listen) of the track/bus
/route/mutea toggleable control to mute/unmute the track/bus
/route/recenablea toggleable control to record-enable the track
/route/panwidthinterpreted by the track/bus panner, should control image "width"
/route/pandirectioninterpreted by the track/bus panner, should control image "direction"
/route/plugin/parameterthe Mth parameter of the Nth plugin of a track/bus +
/route/send/gainthe gain control ("fader") of the Nth send of a 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" -
-
identifies a track or bus by its remote control ID -
-
B, followed by a number -
-
identifies a track or bus by its remote control ID within the current bank (see below for more on banks) -
-
S, followed by a number -
-
identifies a selected track in order they have been selected, S1 should be the same track as the Editor Mixer -
-
one or more words -
-
identifies a track or bus by its name -
-
+ + + + + + + + + +
a number, e.g. "1" +identifies a track or bus by its remote control ID +
B, followed by a number +identifies a track or bus by its remote control ID within the current bank (see below for more on banks) +
S, followed by a number +identifies a selected track in order they have been selected, S1 should be the same track as the Editor Mixer +
one or more words +identifies a track or bus by its name +

For send/insert/plugin controls, the address consists of a track/bus address (as just described) followed by a number identifying the plugin/send @@ -246,64 +245,64 @@ bindings"> In this case, a NoteOn message for note number 13 (on channel 1) will start the transport rolling. The following function names are available:

-
-
+ + + + + + + + + + + + + + + + + + + + + +
transport-stop - -
stop the transport -
-
+
stop the transport +
transport-roll - -
start the transport "rolling" -
-
+
start the transport "rolling" +
transport-zero - -
move the playhead to the zero position -
-
+
move the playhead to the zero position +
transport-start - -
move the playhead to the start marker -
-
+
move the playhead to the start marker +
transport-end - -
move the playhead to the end marker -
-
+
move the playhead to the end marker +
loop-toggle - -
turn on loop playback -
-
+
turn on loop playback +
rec-enable - -
enable the global record button -
-
+
enable the global record button +
rec-disable - -
disable the global record button -
-
+
disable the global record button +
next-bank - -
Move track/bus mapping to the next bank (see Banks below) -
-
+
Move track/bus mapping to the next bank (see Banks below) +
prev-bank - -
Move track/bus mapping to the previous bank (see Banks below) -
- +
Move track/bus mapping to the previous bank (see Banks below) +

Binding to Ardour "actions"

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