X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgeneric-midi-binding-maps.html;h=38361ba7a312bda64101e574f30d539f47032504;hb=fec481cb354390fa2e3e0781b31a4ba7edae2e78;hp=79c471824779caddffd4b44ab42bb9886577ead9;hpb=589948b7303012126787677e22ed5cdd3a0ddc5e;p=ardour-manual diff --git a/include/generic-midi-binding-maps.html b/include/generic-midi-binding-maps.html index 79c4718..38361ba 100644 --- a/include/generic-midi-binding-maps.html +++ b/include/generic-midi-binding-maps.html @@ -43,8 +43,8 @@
  • Roland SI-24
  • Roland V Studio 20
  • WiiMote
    • -
  • Yamaha KX25
  • Xboard 61
    • +
  • Yamaha KX25
    • At this time, new binding maps need to be created with a text editor.

    @@ -102,16 +102,18 @@ bindings">

    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).

    Binding to Track/Bus controls

    - 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 function="… function name …"/> + <Binding msg specification uri="… control address …"/>
    + <Binding msg specification function="… function name …"/>
    + <Binding msg specification action="… action name …"/>

    Message specifications

    @@ -150,29 +152,12 @@ bindings"> that is added to the current value. For use with encoders
  • nrpn-delta - The value is expected to be a signed 14bit value that is added to the current value. For use with encoders
    • -
  • enc-r, enc-l, enc-2 and enc-b - For 7 bit encoders. See below
    • +
  • enc-r, enc-l, enc-2 and enc-b - For 7 bit encoders. + Learn more about working + with encoders

    • -

    - As of Ardour 4.2, enc-r, enc-l, enc-2 and - enc-b may be used for surfaces that have encoders that send - offsets rather than values. These accept Continuous Controller messages - but treat them as offsets. These are good for banked controls as they are - always at the right spot to start adjusting. ( - - 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" @@ -182,7 +167,7 @@ bindings"> 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" ….

    @@ -192,7 +177,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" ….

    @@ -280,19 +265,28 @@ bindings">

    Bindings to Ardour "functions"

    - There is currently no feedback available for 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 - 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:

    <Binding channel="1" note="13" function="transport-roll"/>

    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. +

    +

    + Note that a much greater number of operations are possible using + actions, described below. +

    +

    + The following function names are available:

    @@ -349,8 +343,8 @@ bindings">

    Binding to Ardour "actions"

    - It is not possible to have feedback available for actions because - these represent keyboard shortcuts which are input only. + 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