]> Shamusworld >> Repos - ardour-manual/blob - include/quantize-midi.html
Add foldback strip documentation
[ardour-manual] / include / quantize-midi.html
1
2 <figure>
3     <img src="/images/quantize.png" alt="the Quantize dialog">
4     <figcaption>
5       The Quantize dialog
6     </figcaption>
7 </figure>
8
9 <p>
10   Quantizing a MIDI region, usually one recorded from a MIDI instrument, consists
11   in perfectly aligning the notes with the grid by shifting the notes positions to
12   the closest grid line. The result is a perfectly timed MIDI region, allowing
13   to correct rhythmically poor performance.
14 </p>
15
16 <p>
17   This dialog is accessed via the <kbd class="menu">Region &gt; MIDI &gt; Quantize...</kbd>
18   while having a MIDI region selected, or by <kbd class="mouse">right</kbd> clicking
19   a MIDI region, <kbd class="menu"><em>Name_Of_The_Region</em> &gt; MIDI &gt; Quantize...</kbd>
20   or with the default <kbd class="mod2">5</kbd> shortcut and includes:
21 </p>
22
23 <table class="dl">
24   <tr><th>Snap note start</th>
25       <td>If checked, the start of the notes will be aligned to the grid as defined
26         in the following combo-box (see below)</td></tr>
27   <tr><th>Snap note end</th>
28       <td>If checked, the end of the notes will be aligned to the grid as defined
29         in the following combo-box (see below)</td></tr>
30   <tr><th>Threshold (ticks)</th>
31       <td>Defines how close from a grid point a note must be in order to be quantized. Notes farther than this number of <a href="@@timecode-generators-and-slaves">ticks</a> will not be affected.</td></tr>
32   <tr><th>Strength</th>
33       <td>Defines how close to its new position the note must be moved, as a percentage of the nominal distance (allowing for a non-perfect quantization, i.e. just making the performance rhythmically better without giving it a machine-generated feel)</td></tr>
34   <tr><th>Swing</th>
35       <td>Applies a <em>swing</em> to the midi notes, i.e. delays every 2nd note by this amount, to e.g. simulate a groovy drummer</td></tr>
36 </table>
37
38 <p>
39   The grid selection combo boxes allow a choice between the current <em>main grid</em>, or many beat subdivisions.
40 </p>
41
42 <p>
43   Both note start and note end can be selected at once, resulting in a 2-pass quantization:
44   the note starts are aligned to the grid (with or without the <kbd class="menu">swing</kbd>
45   and <kbd class="menu">Strength</kbd> parameters), then their ends are aligned.
46 </p>
47
48 <p>
49   The swing is a value between 0 and 130, and is relative to the user-selected grid
50   type: every note which is considered a second note (i.e. close enough to an odd
51   grid line as per the threshold value) will be delayed by this number of ticks.
52 </p>
53