Updated VariSpeed refs for v8.1

This commit is contained in:
Alexandre Prokoudine 2023-10-19 18:38:45 +02:00
parent b207eb9b87
commit 979c13772d
2 changed files with 43 additions and 30 deletions

View File

@ -1,5 +1,3 @@
<p> <p>
Ardour supports three common timecode formats: Ardour supports three common timecode formats:
<abbr title="Linear/Longitudinal Time Code"><dfn>LTC</dfn></abbr>, <abbr title="Linear/Longitudinal Time Code"><dfn>LTC</dfn></abbr>,
@ -16,7 +14,6 @@
<dfn>translate</dfn> timecode. e.g create LTC timecode from incoming MTC. <dfn>translate</dfn> timecode. e.g create LTC timecode from incoming MTC.
</p> </p>
<h2>Ardour Timecode Configuration</h2> <h2>Ardour Timecode Configuration</h2>
<p> <p>
@ -83,6 +80,7 @@
</p> </p>
<h3>MTC Generator</h3> <h3>MTC Generator</h3>
<p> <p>
The <dfn>MTC generator</dfn> has no options. Ardour sends full MTC The <dfn>MTC generator</dfn> has no options. Ardour sends full MTC
frames whenever the transport is relocated or changes state (start/stop). frames whenever the transport is relocated or changes state (start/stop).
@ -91,17 +89,20 @@
</p> </p>
<h3>LTC Generator</h3> <h3>LTC Generator</h3>
<p> <p>
The level of the <dfn>LTC generator</dfn> output signal can be configured The level of the <dfn>LTC generator</dfn> output signal can be configured
in the <kbd class="menu">Preferences &gt; Transport</kbd> dialog. By in the <kbd class="menu">Preferences &gt; Transport</kbd> dialog. By
default it is set to -18&nbsp;dBFS, which corresponds to 0dBu in an EBU default it is set to -18&nbsp;dBFS, which corresponds to 0dBu in an EBU
calibrated system. calibrated system.
</p> </p>
<p> <p>
The LTC generator has an additional option to keep sending timecode even The LTC generator has an additional option to keep sending timecode even
when the transport is stopped. This mode is intended to drive analog tape when the transport is stopped. This mode is intended to drive analog tape
machines which unspool the tape if no LTC timecode is received. machines which unspool the tape if no LTC timecode is received.
</p> </p>
<p> <p>
LTC is sent regardless of Ardour's transport speed. It is accurately LTC is sent regardless of Ardour's transport speed. It is accurately
generated even for very slow speeds (&lt;5%) and only limited by the generated even for very slow speeds (&lt;5%) and only limited by the
@ -111,8 +112,8 @@
for high speeds. for high speeds.
</p> </p>
<h2>Ardour Slave Configuration</h2> <h2>Ardour Slave Configuration</h2>
<p> <p>
The timecode source can be switched with the button just right of The timecode source can be switched with the button just right of
Ardour's main clock. By default it is set to <kbd Ardour's main clock. By default it is set to <kbd
@ -121,24 +122,30 @@
timecode source which is chosen in <kbd class="menu">Edit &gt; Preferences timecode source which is chosen in <kbd class="menu">Edit &gt; Preferences
&gt; Transport</kbd>. &gt; Transport</kbd>.
</p> </p>
<p> <p>
When Ardour is <dfn>chasing</dfn> (synchronizing to) an external timecode When Ardour is <dfn>chasing</dfn> (synchronizing to) an external timecode
source, the following cases need to be distinguished: source, the following cases need to be distinguished:
</p> </p>
<ol> <ol>
<li>the timecode source shares the clock</li> <li>the timecode source shares the clock</li>
<li>the timecode source is independent (no wordclock sync)</li> <li>the timecode source is independent (no wordclock sync)</li>
</ol> </ol>
<p>and</p> <p>and</p>
<ol> <ol>
<li>the timecode source uses the same FPS setting as Ardour</li> <li>the timecode source uses the same FPS setting as Ardour</li>
<li>the timecode source runs at different frames-per-second</li> <li>the timecode source runs at different frames-per-second</li>
</ol> </ol>
<p> <p>
In both cases the first option is preferred: clock sync + same FPS setting. In both cases the first option is preferred: clock sync + same FPS setting.
</p> </p>
<h3>Frames-per-second</h3> <h3>Frames-per-second</h3>
<p> <p>
If the frames-per-second do not match, Ardour can either re-calculate If the frames-per-second do not match, Ardour can either re-calculate
and map the frames, or the configured FPS (<kbd class="menu">Session &gt; and map the frames, or the configured FPS (<kbd class="menu">Session &gt;
@ -147,6 +154,7 @@
&gt; Preferences &gt; Transport &gt; Match session video frame rate to &gt; Preferences &gt; Transport &gt; Match session video frame rate to
external timecode</kbd>. external timecode</kbd>.
</p> </p>
<p> <p>
When enabled, the session video frame rate will be changed to match that When enabled, the session video frame rate will be changed to match that
of the selected external timecode source. When disabled, the session video of the selected external timecode source. When disabled, the session video
@ -155,6 +163,7 @@
flash red, and Ardour will convert between the external timecode standard flash red, and Ardour will convert between the external timecode standard
and the session standard. and the session standard.
</p> </p>
<p class="warning"> <p class="warning">
29.97 drop-frame timecode is another corner case. While the SMPTE 12M-1999 29.97 drop-frame timecode is another corner case. While the SMPTE 12M-1999
specifies 29.97df as 30000/1001 frames per second, not all hardware devices specifies 29.97df as 30000/1001 frames per second, not all hardware devices
@ -173,6 +182,7 @@
</p> </p>
<h3>Clock Sync Lock</h3> <h3>Clock Sync Lock</h3>
<p> <p>
As described in the As described in the
<a href="@@on-clock-and-time">On Clock and Time</a> <a href="@@on-clock-and-time">On Clock and Time</a>
@ -180,30 +190,29 @@
source is not in sample-sync with the audio hardware (and JACK), Ardour source is not in sample-sync with the audio hardware (and JACK), Ardour
needs to run at varispeed to adjust for the discrepancy. needs to run at varispeed to adjust for the discrepancy.
</p> </p>
<p> <p>
The checkbox <kbd class="option">External timecode is sync locked</kbd> The checkbox <kbd class="option">External timecode is sync locked</kbd>
allows to select the behavior according to the setup. When enabled, it allows to select the behavior according to the setup. When enabled, it
indicates that the selected external timecode source shares sync (Black indicates that the selected external timecode source shares sync (Black
&amp; Burst, Wordclock, etc) with the audio interface. &amp; Burst, Wordclock, etc) with the audio interface.
</p> </p>
<p> <p>
In other words: if enabled, Ardour will only perform initial In other words: if enabled, Ardour will only perform initial
synchronization and keep playing at speed 1.0 instead of vari-speed synchronization and keep playing at speed 1.0 instead of vari-speed
adjusting to compensate for drift. adjusting to compensate for drift.
</p> </p>
<p class="note">
Note that vari-speed is unavailable when recording in Ardour, and all
tracking happens at speed 1.0. So in order to record in sync with
external timecode it must be sample-locked or it will drift over time.
</p>
<h3>MIDI Clock</h3> <h3>MIDI Clock</h3>
<p> <p>
<dfn>MIDI Clock</dfn> is not a timecode format but tempo-based time. The <dfn>MIDI Clock</dfn> is not a timecode format but tempo-based time. The
absolute reference point is expressed as beats-per-minute and Bar, Beat absolute reference point is expressed as beats-per-minute and Bar, Beat
and Tick. There is no concept of sample-locking for MIDI clock signals. and Tick. There is no concept of sample-locking for MIDI clock signals.
Ardour will vari-speed if necessary to chase the incoming signal. Ardour will vari-speed if necessary to chase the incoming signal.
</p> </p>
<p> <p>
Note that the MIDI Clock source must be connected to the Note that the MIDI Clock source must be connected to the
<code>ardour:MIDI clock in</code> port. <code>ardour:MIDI clock in</code> port.
@ -271,23 +280,26 @@
</p> </p>
<p> <p>
When Ardour is chasing MTC, the main transport clock will display the When Ardour is chasing MTC, the main transport clock will display the
received Timecode as well as the delta between the incoming signal and received timecode as well as the delta between the incoming signal and
Ardour's transport position. Ardour's transport position.
</p> </p>
<h3>JACK Transport</h3> <h3>JACK Transport</h3>
<p> <p>
When slaved to jack, Ardour's transport will be identical to When slaved to jack, Ardour's transport will be identical to JACK Transport.
JACK-transport. As opposed to other slaves, Ardour can be used to control As opposed to other slaves, Ardour can be used to control the JACK transport
the JACK transport states (stopped/rolling). No port connections need to states (stopped/rolling). No port connections need to be made for
be made for jack-transport to work. JACK Transport to work.
</p> </p>
<p> <p>
JACK-transport does not support vari-speed, nor offsets. Ardour does not JACK Transport does not support vari-speed, nor offsets. Ardour does not
chase the timecode but is always in perfect sample-sync with it. chase the timecode but is always in perfect sample-sync with it.
</p> </p>
<p> <p>
JACK-transport also includes temp-based-time information in Bar:Beats:Ticks JACK Transport also includes temp-based time information in Bar:Beats:Ticks
and beats-per-minute. However, only one JACK application can provide this and beats-per-minute. However, only one JACK application can provide this
information at a given time. The checkbox information at a given time. The checkbox
<kbd class="option">Session &gt; Properties &gt; JACK Time Master</kbd> <kbd class="option">Session &gt; Properties &gt; JACK Time Master</kbd>

View File

@ -61,9 +61,9 @@
allows to <em>temporarily</em> scrub through the audio quickly. The slider allows to <em>temporarily</em> scrub through the audio quickly. The slider
decides the playback speed: the further from the center it is set, decides the playback speed: the further from the center it is set,
the faster the playback will scrub in both directions. The range of the faster the playback will scrub in both directions. The range of
this acceleration can be set by <kbd class="mouse">right</kbd> this acceleration can be set by <kbd class="mouse">right</kbd>-clicking
clicking the control and setting the multiplier, between 1.5 the control and setting the multiplier, either 1.5 (&plusmn; 150%) or 2
(&plusmn; 150%) and 8 (&plusmn; 800%). (&plusmn; 200%).
</p> </p>
<h4 id="transport_varispeed">VariSpeed</h4> <h4 id="transport_varispeed">VariSpeed</h4>
@ -71,21 +71,22 @@
The <kbd class="menu">VS</kbd> (for <em>V</em>ari<em>S</em>peed) The <kbd class="menu">VS</kbd> (for <em>V</em>ari<em>S</em>peed)
button sets a <em>constant</em> playback/record speed. It can be set button sets a <em>constant</em> playback/record speed. It can be set
in semitones (1 semitone = &times; 2 <sup>1&frasl;12</sup> &asymp; in semitones (1 semitone = &times; 2 <sup>1&frasl;12</sup> &asymp;
105,9%), or cents of semitones, and is armed/disarmed by clicking the 105,9%), cents of semitones, or percentages, and is armed/disarmed
button. The <kbd class="menu">VS</kbd> button will blink when VariSpeed by clicking the button. The <kbd class="menu">VS</kbd> button will blink
is enabled. Whether or not this VariSpeed is persistent when when VariSpeed is enabled. Whether or not this VariSpeed is persistent
stopping/restarting transport depends on the <kbd class="option">Reset when stopping/restarting transport depends on the
default speed on stop</kbd> parameter in the <a <kbd class="option">Reset default speed on stop</kbd> parameter in the
href="@@preferences#preferences-transport">Preferences</a>. <a href="@@preferences#preferences-transport">Preferences</a> dialog.
</p> </p>
<h4 id="transport_sync">Transport Sync</h4> <h4 id="transport_sync">Transport Sync</h4>
<p> <p>
On the left of the slider is the positional sync button (which might show <dfn>Internal</dfn>, On the left of the slider is the positional sync button (which might show
or <dfn>MTC</dfn> or several other values), than can be used to control whether or not the <dfn>Internal</dfn>, or <dfn>MTC</dfn> or several other values), than can be
transport position and start is controlled by Ardour, or by an external positional used to control whether or not the transport position and start is controlled
synchronization source, such as MIDI Time Code (MTC), Linear Time Code (LTC) or JACK by Ardour, or by an external positional synchronization source, such as MIDI
(see <a href="@@timecode-generators-and-slaves">Timecode Generators and Slaves</a>). Time Code (MTC), Linear Time Code (LTC) or JACK (see
<a href="@@timecode-generators-and-slaves">Timecode Generators and Slaves</a>).
</p> </p>
<h4 id="transport_status">Transport Status</h4> <h4 id="transport_status">Transport Status</h4>