Tempo ruler update for 8.0

This commit is contained in:
Alexandre Prokoudine 2023-10-08 04:41:12 +02:00
parent 1ac6b9a205
commit c954432ec9

View File

@ -1,14 +1,16 @@
<p>
The Tempo ruler allows changing tempo within one session, either abruptly or
gradually over time. This is done by placing tempo markers on the ruler and
setting up how exactly the transition happens.
setting up how exactly the transition happens. Alternatively, in the
<a href="/ardours-interface/the-toolbox#grid">Grid mode</a>, markers can be
added and edited directly on the timeline.
</p>
<p>
On the screenshot below, there are 4 bars of music at 120bpm starting at bar 27,
then the tempo changes abruptly to 140bpm and goes on for another 4 bars at that
tempo, then abruptly changes back to 120bpm and within the next 4 bars gradually
goes back to 140bpm, then continues at 140bpm until the end of the session.
goes back to 140bpm, then continues at 140bpm until the end of the session.
</p>
<figure>
@ -17,46 +19,10 @@
<figcaption>Changes in tempo over time</figcaption>
</figure>
<h2>Tempo ruler modes</h2>
<p>
The Tempo ruler has two modes: editing tempo and mapping tempo. The mode can
be selected in the <kbd class="menu">Edit &gt; Tempo</kbd> menu.
Additionally, users can select which one should be enabled by default
<kbd class="menu">Edit &gt; Preferences &gt; Metronome &gt; Default tempo
ruler state for new sessions</kbd>.
</p>
<p>
The Map Tempo mode is best suited for cases when there is a live recording
of an instrument or multiple instruments, with some tempo imperfections. So
before more instruments are added, e.g. MIDI-programmed drums, the tempo map
needs to be adjusted to match the actual performance. In this mode, MIDI data
is not adjusted for tempo map changes, so if the live recording contains
both audio and MIDI tracks, the notes will stay exactly where they are.
Additionally, tweaking tempo markers does not change the wall clock position
of other tempo markers.
</p>
<figure>
<img style="width:75%;" width="50%" src="/images/map-tempo-example.png"
alt="An example of mapping tempo to performance">
<figcaption>An example of mapping tempo to performance</figcaption>
</figure>
<p>
The Change Tempo mode is better suited for cases when the musician either
starts a session from scratch and creates the tempo map at the beginning, or
when they do need the MIDI data to be adjusted for tempo map changes.
Tweaking tempo in a tempo marker in this mode also changes the wall clock
position of subsequent tempo markers.
</p>
<h2>Anatomy of tempo markers</h2>
<p>
When working with the tempo ruler in the Change Tempo mode, each tempo
marker exposes several editable properties:
Each tempo marker exposes several editable properties:
</p>
<ul>
@ -81,12 +47,7 @@
</li>
</ul>
<p>
In the Map Tempo mode, tempo markers also have these properties, but except
for the BPM at the start value, they are not exposed in the user interface.
</p>
<h2>Working with tempo markers in the Edit Tempo mode</h2>
<h2>Working with tempo markers on the ruler</h2>
<h3>Adding Tempo Markers</h3>
@ -194,7 +155,7 @@
properties menu and applies forward in the timeline. Alternatively, you can
right-click a tempo marker and select the <kbd class="menu">Ramp to Next</kbd>
menu item. Tempo will gradually accelerate or decelerate until the target
tempo is reached, resulting in a musical <em>accel.</en> or <em>ritard.</em>.
tempo is reached, resulting in a musical <em>accel.</em> or <em>ritard.</em>
</p>
<p>
@ -221,48 +182,14 @@
music is moved).
</p>
<h2>Working with tempo markers in the Map Tempo mode</h2>
<h3>Adding tempo markers</h3>
<h2>Working with tempo markers in the Grid mode</h2>
<p>
In the Map Tempo mode, new tempo markers are only created at bar lines. Hover
a bar line on the tempo ruler, this will change the mouse pointer. Then click
and drag to align the bar line with an onset. A new tempo marker will be
automatically created.
For documentation on editing the tempo map in the Grid mode, please see
the <a href="/ardours-interface/the-toolbox#grid">relevant part</a> of the
Toolbox chapter.
</p>
<figure>
<img style="width:50%;" width="50%" src="/images/map-tempo-bar-line.png"
alt="Ramping in Map Tempo mode">
<figcaption>Creating a tempo marker in Map Tempo mode</figcaption>
</figure>
<h3>Tweaking positions of markers</h3>
<p>
To tweak the position of a tempo marker, hover the bar line where it's
located, then click and drag it left or right.
</p>
<h3>Ramping between tempo markers</h3>
<p>
In some cases, tempo fluctuates gradually during the performance. To deal
with that, it's possible to set a tempo ramp. Create two markers, one where
tempo begins changing, and one where it starts changing. Then hover the
mouse pointer between bar lines and start dragging to the left or to the
right. Dragging to the left increases the tempo at the beginning and lowers
it towards the end. Dragging to the right increases the tempo towards the
end and lowers it towards the beginning.
</p>
<figure>
<img style="width:50%;" width="50%" src="/images/map-tempo-beat-line.png"
alt="Ramping in Map Tempo mode">
<figcaption>Ramping in Map Tempo mode</figcaption>
</figure>
<h2>Further Information</h2>
<p>