]> Shamusworld >> Repos - ardour-manual/blobdiff - include/patch-change.html
Clarifying in which mode changes can be edited
[ardour-manual] / include / patch-change.html
index 55d6cc0ef2f1c4afaca9e057d35b569d39f68d52..57f50e6ce59648f23931bfd55923ba21027b15fa 100644 (file)
@@ -1,54 +1,91 @@
 
+<figure class="right">
+<img src="/images/patch_change.png" alt="A patch change in a MIDI region"/>
+<figcaption class="center">A patch change in a MIDI region</figcaption>
+</figure>
+
 <p>
-  A <dfn>patch change</dfn> is Ardour's description for a combination
-  of MIDI program change and bank select messages, that (typically)
-  instruct a synthesizer or sampler to select a different sound to use
-  on a particular channel.
-</p>
-<p>
-  Patch changes are shown within MIDI regions as small rectangles or
-  <dfn>flags</dfn>, as shown below:
+  A <dfn>Patch Change</dfn> is Ardour's description for a combination of MIDI
+  program change and bank select messages, that typically instruct a
+  synthesizer or sampler to select a sound to use on any given channel. Patch
+  changes are shown within MIDI regions as small rectangles or
+  <dfn>flags</dfn>, with a vertical line showing where in the region the patch
+  change will occur.
 </p>
 
 <h2>Inserting Patch Changes</h2>
+
+<figure class="right">
+<img src="/images/region-midi-r-click-menu.png" alt="Region > MIDI context menu"/>
+<figcaption class="center">MIDI context menu</figcaption>
+</figure>
+
+<figure class="right">
+<img src="/images/patch-change-dlg.png" alt="Patch Change dialog"/>
+<figcaption class="center">Patch Change dialog</figcaption>
+</figure>
+
+<figure class="right">
+<img src="/images/patch-r-click-menu.png" alt="Patch Change context menu"/>
+<figcaption class="center">Patch Change context menu</figcaption>
+</figure>
+
+<p>
+  A patch change is inserted by first ensuring that the mouse is in <a
+  href="@@toolbox">Grab Mode</a>, then <kbd class="mouse">right</kbd>-clicking
+  on the MIDI region where the patch changed is desired, then selecting <kbd
+  class="menu">&lt;Region Name&gt; &gt; MIDI &gt; Insert Patch Change...</kbd>.
+  The desired patch is then chosen from the dialog that appears.
 <p>
-  Ensure that the
-  <a href="/ardours-interface/the-edit-point-control/">edit point</a> is 
-  located where you want the patch change to be (within an existing
-  MIDI region). Context click, and from the MIDI region's context menu,
-  select <kbd class="menu">MIDI &gt; Insert Patch Change</kbd>. A
-  dialog will appear allowing you to set the bank and program values.
+
+<p class="note">
+  Inserted patch changes always appear in the selected region at the <a
+  href="@@edit-point-control">Edit Point</a>.
 </p>
 
 <h2>Modifying Patch Changes</h2>
+
 <p>
-  Context-clicking on a patch change will bring up the same dialog that
-  was used to create it, allowing you to modify the program and/or bank
-  numbers.
-</p>
-<p>
-  You can also use the mouse wheel: <kbd class="mouse">&uArr;</kbd>/<kbd
-  class="mouse">&dArr;</kbd> on the patch change will alter the program
-  number, <kbd class="mouse mod1">&uArr;</kbd>/<kbd
-  class="mouse mod1">&dArr;</kbd> will modify the bank number.
+  A patch change can be modified in <a href="@@toolbox">Internal Edit Mode</a> by <kbd class="mouse">right</kbd>-clicking on
+  it, then selecting the desired patch from the menu that appears. A patch
+  change can also be modified by hovering the mouse pointer over the patch
+  change to be modified and moving the mouse wheel until the desired program
+  number is selected. The bank number can be modified similarly by holding down
+  the <kbd class="mod3"></kbd> key while moving the mouse wheel until the
+  desired bank is selected.
 </p>
 
 <h2>Moving Patch Changes</h2>
+
 <p>
-  Just <kbd class="mouse">Left</kbd>-drag on the patch change to move it
-  around.
+  A patch change can be moved, within the region in which it resides, by <kbd
+  class="mouse">left</kbd>-clicking it and dragging it to the desired location.
 </p>
 
 <h2>Removing Patch Changes</h2>
+
 <p>
-  Put the mouse pointer into the rectangular area, and press <kbd>Del</kbd>
-  or use the delete mouse button operation. This will remove the patch change
-  (the operation can be undone).
+  A patch change can be removed by holding down the <kbd class="mod3"></kbd> key
+  and then <kbd class="mouse">right</kbd>-clicking on it.
 </p>
 
-<h2>Names for Patch Numbers: MIDNAM files</h2>
+<h2 id="midnam">Names for Patch Numbers: MIDNAM files</h2>
 
-<p class=fixme>
-  Add content
+<p>
+  MIDNAM files assign human-readable names to the "sound coordinates" (Program
+  Change, Bank Select) of MIDI synthesizers and devices. A number of MIDNAM
+  files come bundled with Ardour; if the MIDNAM for a device is not included
+  with Ardour, <a href="@@midnam-ref">a custom MIDNAM file can be created</a>
+  for device in question.
+</p>
+
+<h3>Selecting a device</h3>
+
+<p>
+  Selecting a MIDNAM is only possible if there is no MIDI synth on the track in
+  question or the MIDI synth does not have a MIDNAM associated with it. In this
+  case, it is possible to select the desired MIDNAM from a combobox in the MIDI
+  track's header, usually directly below the track's fader. See <a
+  href="@@midi-track-controls">MIDI Track Controls</a> for more details.
 </p>