]> Shamusworld >> Repos - ardour-manual/blob - include/midi-track-controls.html
6a4b5966ea5533f1d1ecaff0cbf0900330310fb1
[ardour-manual] / include / midi-track-controls.html
1
2 <p>A typical <dfn>MIDI track header</dfn> looks like this:</p>
3 <figure>
4     <img src="/images/typical-midi-track-controls.png" alt="A MIDI track header">
5     <figcaption>
6       A MIDI track header
7     </figcaption>
8 </figure>
9
10 <p>
11   To show the full set of MIDI track controls, the <a href="@@track-height">track height</a>
12   must be increased beyond the default. MIDI tracks show only a few of the control elements
13   when there is insufficient vertical space.
14 </p>
15 <p>
16   A MIDI track has the same basic controls as an <a href="@@audio-track-controls">audio track</a>,
17   with the addition of three extra elements:
18 </p>
19 <ol>
20   <li>Some meters for the track's outputs (MIDI in <span style="color:red;">red</span>,
21     Audio in <span style="color:green;">green</span>)</li>
22   <li>The <dfn>Scroomer</dfn>, a zoom and scroll controller for the midi notes range</li>
23   <li>When the track is tall enough, the External MIDI Device selection dropdown appears.</li>
24 </ol>
25
26 <p>
27         Also, <kbd class="mouse">right</kbd> clicking the <kbd style="color:red;">&#9679;</kbd>
28         (record) button shows the <a href="@@step-entry">Step Entry</a> dialog instead of
29         controlling the rec-safe.
30 </p>
31
32 <h2>The Scroomer</h2>
33
34 <p>
35   The Scroomer performs a couple of functions:
36 </p>
37 <ul>
38   <li>The scrollbar controls the range of pitches that are visible on the
39     track, as visualized by the piano keyboard. Dragging the body of the scrollbar up
40     and down displays higher or lower pitches.</li>
41   <li>Dragging the scrollbar handles zooms in and out and increases or decreases the
42     range of visible pitches.</li>
43   <li>Double clicking the scrollbar auto-adjusts the zooms to make the range of
44     visible pitches fit the actual content of the track.</li>
45   <li>Clicking on the piano plays the corresponding MIDI note for reference.</li>
46   <li><kbd class="mouse mod3">left</kbd> clicking on a note adds the note to the
47                 selection (for all regions on the track). See <a href="@@note-selection">Note
48                 Selection</a>.</li>
49         <li><kbd class="mouse">middle</kbd> clicking a note clears the selection, selects
50                 only the note.</li>
51 </ul>
52
53 <h2>Channel and patch selection</h2>
54
55 <h3>The Channel Selector</h3>
56
57 <figure class="right">
58     <img class="mini" src="/images/midi_channel_control.png" alt="The MIDI channel control window">
59     <figcaption>
60       The MIDI channel control window
61     </figcaption>
62 </figure>
63
64 <p>
65   A MIDI track's data may span any number of the 16 available MIDI channels, and sometimes it is
66   useful to view only a subset of those channels; different instruments may,
67   for example, be put on different channels. In the context menu (<kbd class="mouse">right</kbd> click),
68   the <kbd class="menu">Channel Selector</kbd> allows to control the <dfn>MIDI channel</dfn>(s)
69   that will be visible in the editor.
70 </p>
71
72 <p>
73   This window also gives control over which channel(s) will be recorded, and which will be played back, choosing between:
74 </p>
75
76 <ul>
77   <li>All channels</li>
78   <li>Only selected channels &mdash;Ardour then proposes to choose amongst the 16 channels which are to be recorded/played</li>
79   <li>Force all to one channel &mdash;Ardour then 'routes' all the channels to one user selectable channel.</li>
80 </ul>
81
82 <h3 class="clear">The Patch Selector</h3>
83
84 <figure class="left">
85     <img class="mini" src="/images/patch_selector.png" alt="The Patch Selector window">
86     <figcaption>
87       The Patch Selector window
88     </figcaption>
89 </figure>
90
91 <p>
92   The Patch Selector window is an easy way to set which instrument will be used on any of the MIDI channels.
93   Although patches can be changed at any time using a <a href="@@patch-change">patch change</a>, this dialog
94   provides an easy and convenient way to preview patches in software and hardware instruments. It
95   integrates fully with Ardour's support for MIDNAM (patch definition files), so Ardour can display named programs/patches
96   for both General MIDI synths and those with MIDNAM files.
97 </p>
98 <p>
99   The window itself makes it easy to choose a channel, a bank number, optionally choosing a bank number through its <dfn title="Most Significant Byte">MSB</dfn>
100   and <dfn title="Least Significant Byte">LSB</dfn> numbers (CC#00 and CC#32) for large banks, then choosing an instrument.
101 </p>
102 <p>
103   The keyboard at the bottom of the window allows for a quick preview of the selected instrument, either automatically
104   (using the buttons on top of the keyboard) or manually by either clicking a note or using the computer keyboard as a
105   piano keyboard.
106 </p>
107
108 <p>
109   To edit the contents of a MIDI track see <a href="@@edit-midi">MIDI Editing</a>.
110 </p>