Shamusworld >> Repos - ardour-manual/blob - include/patch-change.html

   1
   2 <figure class="right">
   3   <img src="/images/patch_change.png" alt="A patch change in a MIDI region"/>
   4   <figcaption>A patch change in a MIDI region</figcaption>
   5 </figure>
   6
   7 <p>
   8   A <dfn>patch change</dfn> is Ardour's description for a combination
   9   of MIDI program change and bank select messages, that (typically)
  10   instruct a synthesizer or sampler to select a different sound to use
  11   on a particular channel.
  12 </p>
  13 <p>
  14   Patch changes are shown within MIDI regions as small rectangles or
  15   <dfn>flags</dfn>, with a vertical line showing where in the region
  16   (hence "when") this patch change happens.
  17 </p>
  18
  19 <h2>Inserting Patch Changes</h2>
  20 <p>
  21   To insert a patch change, the <a href="@@edit-point-control">edit point</a>
  22   should be located where the patch change should be (within an existing MIDI
  23   region). When <kbd class="mouse">right</kbd> clicking, and from the MIDI
  24   region's context menu, selecting <kbd class="menu">MIDI &gt; Insert Patch
  25   Change</kbd>, a dialog appears allowing to set the bank and program values.
  26 </p>
  27
  28 <h2>Modifying Patch Changes</h2>
  29 <p>
  30   Context-clicking on a patch change will bring up the same dialog that
  31   was used to create it, allowing to modify the program and/or bank
  32   numbers.
  33 </p>
  34 <p>
  35   The mouse wheel can also be used: <kbd class="mouse">&uArr;</kbd>/<kbd
  36   class="mouse">&dArr;</kbd> on the patch change will alter the program
  37   number, <kbd class="mouse mod1">&uArr;</kbd>/<kbd
  38   class="mouse mod1">&dArr;</kbd> will modify the bank number.
  39 </p>
  40
  41 <h2>Moving Patch Changes</h2>
  42 <p>
  43   Just <kbd class="mouse">Left</kbd>-dragging the patch change moves it
  44   around.
  45 </p>
  46
  47 <h2>Removing Patch Changes</h2>
  48 <p>
  49   Pressing <kbd>Del</kbd> with the mouse pointer into the rectangular area, or
  50   using the <kbd class="menu">delete</kbd> mouse button operation will remove the
  51   patch change (the operation can be undone).
  52 </p>
  53
  54 <h2>Names for Patch Numbers: MIDNAM files</h2>
  55 <p>
  56   MIDNAM files assign human-redable names to the "coordinates" (MSB, LSB, pc) of
  57   instruments and controls of MIDI-devices. A number of MIDNAM files come already pre-bundled
  58   with Ardour. Should this not be the case for your device, you can add your own (see below).
  59 </p>
  60
  61 <h3>Selecting a device</h3>
  62 <p>
  63   For the proper names to show up in the "Patch Selector"-dialog, you have to assign a
  64   device to your current track. To do so, hover the lower border of the tracks header
  65   (the mouse-cursor will change to a "resize-cursor") and expand it.
  66   You'll see dropdown menus. Select your device in the menu.
  67 </p>
  68
  69 <h3>Adding a custom MIDNAM-file</h3>
  70 <p>
  71   MIDNAM-files are XML-Files. You can edit them using your favorite text-editor. When
  72   doing so, please ensure to change the "Model" of the device, as Ardour will only load
  73   each model once (i.e. it will skip files, if there are clashes).
  74 </p>
  75 <p>
  76   After you have done modifications to a file, it's a good idea to validate it. This can
  77   be done using the tool <i>xmllint</i> as shown below:
  78 </p>
  79 <pre><code class="bash">
  80 $ xmllint --valid --noout myfile.midnam
  81 $ wget http://www.midi.org/dtds/MIDINameDocument10.dtd
  82 $ xmllint --dtdvalid MIDINameDocument10.dtd myfile.midnam
  83 </code></pre>
  84 <p>
  85   Once you are satisfied with your file, you have to put it at a location where Ardour
  86   picks it up. The best place would be the (hidden) directory
  87   <a href="@@files-and-directories-ardour-knows-about">Ardour configuration directory</a>
  88   subdirectory patchfiles.
  89   in your home-folder. Should the sub-directory <i>patchfiles</i> not exist yet, just
  90   create it. The path and file-names are case-sensitive. The file should end with
  91   "<i>.midnam</i>".
  92 </p>
  93 <p>
  94   After restarting Ardour, hit the small Log-button in the upper right corner of the
  95   main window. It should say something like
  96   (this is Linux, Macos or Windows will be different):
  97 </p>
  98 <pre>[INFO]: Loading 3 MIDI patches from /home/username/.config/ardour5/patchfiles</pre>
  99 <p>
 100   The added device should now show up in the dropdown mentioned in the previous paragraph.
 101 </p>
 102 <p>
 103   Should the MIDNAM-file be useful for the general public, it would be nice to share it:
 104   Fork the Ardour-project on <a href="https://github.com/Ardour/ardour">gitHub</a> by
 105   hitting the "Fork"-Button. Go to the <a>patchfiles</a>-directory (and read the README).
 106 </p>
 107 <p>
 108   You can upload the file using the Web-Interface. Be sure to select
 109   "<i>Create a new branch for this commit and start a pull request</i>".
 110 </p>