]> Shamusworld >> Repos - ardour-manual/blob - include/clip-stretch-options.html
Clarify video-tools install, remove symlink suggestion
[ardour-manual] / include / clip-stretch-options.html
1 <h2>Stretching</h2>
2
3 <p>
4         When you load an audio clip into a trigger slot, Ardour applies some
5         heuristics to estimate its temo in beats per minute. Unless a metadata
6         in the file source provides information,
7         <a href="https://github.com/breakfastquay/minibpm">minibpm</a> is used
8         to analyze and detect the file's BPM.
9 </p>
10
11 <p>
12         After tempo is estimated, the clip is time-stretched to match the
13         session's tempo map. This means that should session's tempo change over
14         time (in either ramped or constant mode), all audio clips will be
15         re-stretched to accomodate for that.
16 </p>
17
18 <p>
19         Disabling stretching when original clip's tempo doesn't match that of the
20         session will most of the times make the clip audibly go out of sync with
21         the beat.
22 </p>
23
24 <p>Stretch modes:</p>
25
26 <p>
27         Once stretching is enabled, you have several options how to apply it:
28 </p>
29
30 <ul>
31   <li><dfn>Crisp</dfn> works best for sounds with fast onset like drums and percussion</li>
32   <li><dfn>Smooth</dfn> is best used for sustained notes like pads</li>
33   <li><dfn>Mixed</dfn> is for anything in between</li>
34 </ul>
35
36 <h2>BPM</h2>
37
38 <p>
39         This is where the estimated tempo is displayed. It can also
40         be progressively divided or mutiplied by two.
41 </p>
42
43 <p>
44         Supposing, session's tempo is currently 120bpm and original clip's tempo
45         is 90bpm. Stretching the clip to match session's tempo will make it sound
46         faster that it originally is.
47 </p>
48
49 <p>
50         If the estimated clip's tempo is divided by 2, stretching the resulted
51         45bpm back to 120bpm will make the clip sound faster. Vice versa,
52         multiplying the original clip's tempo by 2 and then stretching it down
53         from 180bpm to 120bpm will make the clip sound slower than it originally is.
54 </p>
55
56 <h2>Clip Length</h2>
57
58 <p>
59         This control allows adjusting the estimated tempo in a finer manner,
60         by changing the amount of beats it takes to play the clip in the selected
61         trigger slot. The change is immediately displayed in the BPM field above.
62 </p>
63
64 <h2>Length in Bars</h2>
65
66 <p>
67         This is an estimate of the clip's length as measured in bars for two
68         popular time signatures: 4/4 and 3/4.
69 </p>