manual/include/overview-of-all-timecode-related-settings.html

<p>
  Timecode settings are accessed from the menu in three places:
</p>

<ul>
  <li><kbd class="menu">Session &gt; Properties &gt; Timecode</kbd></li>
  <li><kbd class="menu">Edit &gt; Preferences &gt; Transport</kbd></li>
  <li><kbd class="menu">Edit &gt; Preferences &gt; MIDI</kbd></li>
</ul>

<h2>Timecode Settings</h2>
<dl>
  <dt><kbd class="menu">Timecode frames-per-second</kbd></dt>
  <dd>
    Configure timecode frames-per-second (23.976, 24, 24.975, 25, 29.97, 
    29.97 drop, 30, 30 drop, 59.94, 60). Note that all fractional 
    framerates are actually fps*(1000.0/1001.0).
  </dd>
  <dt><kbd class="menu">Pull up/down</kbd></dt>
  <dd>
    Video pull-up modes change the effective samplerate of Ardour to 
    allow for changing a film soundtrack from one frame rate to another. 
    See <a href="http://en.wikipedia.org/wiki/Telecine">Telecine</a>
  </dd>
  <dt><kbd class="menu">Slave Timecode offset</kbd></dt>
  <dd>
    The specified offset is added to the received timecode (MTC or
    LTC).
  </dd>
  <dt><kbd class="menu">Timecode Generator offset</kbd></dt>
  <dd>
    Specify an offset which is added to the generated timecode (so far only LTC).
  </dd>
  <dt><kbd class="option">JACK Time Master</kbd></dt>
  <dd>
    Provide Bar|Beat|Tick and other information to JACK.
  </dd>
</dl>
<p>These settings are session specific.</p>


<h2>Transport Preferences</h2>
<dl>
  <dt><kbd class="menu">External timecode source</kbd></dt>
  <dd>
    Select timecode source: JACK, LTC, MTC, MIDI Clock
  </dd>
  <dt><kbd class="option">Match session video frame rate to external timecode</kbd></dt>
  <dd>
    This option controls the value of the video frame rate <em>while 
    chasing</em> an external timecode source. When enabled, the 
    session video frame rate will be changed to match that of the selected 
    external timecode source. When disabled, the session video frame rate 
    will not be changed to match that of the selected external timecode 
    source. Instead the frame rate indication in the main clock will flash 
    red and Ardour will convert between the external timecode standard and 
    the session standard.
  </dd>
  <dt><kbd class="option">External timecode is sync locked</kbd></dt>
  <dd>
    Indicates that the selected external timecode source shares sync (Black 
    &amp; Burst, Wordclock, etc) with the audio interface.
  </dd>
  <dt><kbd class="option">Lock to 29.9700 fps instead of 30000/1001</kbd></dt>
  <dd>
    The external timecode source is assumed to use 29.97 fps instead of 
    30000/1001. SMPTE 12M-1999 specifies 29.97df as 30000/1001. The spec 
    further mentions that drop-frame timecode has an accumulated error of -86ms 
    over a 24-hour period. Drop-frame timecode would compensate exactly for a 
    NTSC color frame rate of 30 * 0.9990 (ie 29.970000). That is not the actual 
    rate. However, some vendors use that rate&mdash;despite it being against 
    the specs&mdash;because the variant of using exactly 29.97 fps has zero 
    timecode drift.
  </dd>
  <dt><kbd class="menu">LTC incoming port</kbd></dt>
  <dd>
    Offers a session agnostic way to retain the LTC port connection.
  </dd>
  <dt><kbd class="option">Enable LTC generator</kbd></dt>
  <dd>Does just what it says.</dd>
  <dt><kbd class="option">Send LTC while stopped</kbd></dt>
  <dd>
    Enable to continue to send LTC information even when the transport 
    (playhead) is not moving. This mode is intended to drive analog tape 
    machines which unspool the tape if no LTC timecode is received.
  </dd>
  <dt><kbd class="menu">LTC generator level</kbd></dt>
  <dd>
    Specify the Peak Volume of the generated LTC signal in dbFS. A good value 
    is 0&nbsp;dBu (which is -18&nbsp;dbFS in an EBU calibrated system).
  </dd>
</dl>
<p>These settings are common to all sessions.</p>


<h2>MIDI Preferences</h2>
<dl>
  <dt><kbd class="option">Send MIDI Timecode</kbd></dt><dd>Enable MTC generator</dd>
  <dt><kbd class="option">Send MIDI Clock</kbd></dt><dd>Enable MIDI Clock generator</dd>
</dl>
<p>These settings are also common to all sessions.</p>