Shamusworld >> Repos - ardour-manual/blob - _manual/02_introducing-ardour/03_basic-gui-operations/08_editing-clocks.html

   1 ---
   2 layout: default
   3 title: Editing Clocks
   4 ---
   5 <h2>Clock Modes</h2>
   6
   7 <p>
   8   Every clock in Ardour has four different, selectable <dfn>clock
   9   modes</dfn>. Each mode displays time using different units.
  10   You can change the clock mode by <kbd class="mouse">Right</kbd>-clicking
  11   on the clock and selecting the desired mode from the menu. Some clocks are
  12   entirely independent of any other clock's mode; others are linked so that
  13   changing one changes all clocks in that group. The different modes are:
  14 </p>
  15
  16 <dl>
  17   <dt>Timecode</dt><dd>Time is shown as <dfn><abbr title="Society of Motion Picture and Television
  18   Engineers">SMPTE</abbr> timecode</dfn> in Hours:Minutes:Seconds:Frames,
  19   measured from the timecode zero point on the timeline (which may not
  20   correspond to the session start and/or absolute zero on the timeline,
  21   depending on configurable timecode offsets).
  22   The frames value is dictated by either the session <abbr title="Frames Per
  23   Second">FPS</abbr> setting, or, if slaved to an external timecode master,
  24   the master's setting. In the transport clocks, the FPS value is shown below
  25   the time display, along with an indication of the current timecode source
  26   (<samp>INT</samp> means that Ardour is its own timecode source).</dd>
  27   <dt>BBT</dt><dd>Time is shown as Bars:Beats:Ticks, indicating <dfn>musical time</dfn> measured
  28   from the start of the session. The transport clocks show the current tempo
  29   in <abbr title="Beats Per Minute">bpm</abbr> and meter below the time
  30   display.</dd>
  31   <dt>Minutes:Seconds</dt><dd>Time is shown as Hours:Minutes:Seconds.Milliseconds, measured from the
  32   absolute start of the timeline (ignoring the session start and any timecode
  33   offsets).</dd>
  34   <dt>Samples</dt><dd>Time is shown as a <dfn>sample count</dfn> from the absolute start of the timeline
  35   (ignoring the session start and any timecode offsets). The number of
  36   samples per second is given by the current sample rate, and in the transport
  37   clocks, this rate is shown below the time display along with any
  38   pullup/pulldown adjustment.</dd>
  39 </dl>
  40
  41 <h2>Changing clock values with the keyboard</h2>
  42
  43 <p>
  44   New values for the clock can be typed in after clicking on the relevant clock.
  45   Clicking on the clock will show a thin vertical cursor bar just to the right
  46   of the next character to be overwritten. Enter time in the same order as the
  47   current clock mode&mdash;if the clock is in Timecode mode, you need to enter
  48   hours, minutes, seconds, frames. So, to change to a time of 12:15:20:15 you
  49   would type <kbd class="input">1 2 1 5 2 0 1 5</kbd>. Each number you type will
  50   appear in a different color, from right to left, overwriting the existing value.
  51   Mid-edit, after typing <kbd class="input">3 2 2 2</kbd> the clock might look like this:
  52 </p>
  53
  54 <img src="/images/clockedit.png" alt="An image of a clock being edited in Ardour">
  55
  56 <p>
  57   To finish the edit, press <kbd>&crarr;</kbd> or <kbd>Tab</kbd>. To exit an
  58   edit without changing the clock press <kbd>ESC</kbd>. If you mis-type an entry
  59   so that the new value would be illegal (for example, resulting in more than 30
  60   frames when Timecode is set to 30 frames per second), the clock will reset at
  61   the end of the edit, and move the cursor back to the start so that you can
  62   start over.
  63 </p>
  64
  65 <h2>Avoiding the mouse entirely</h2>
  66
  67 <p>
  68   There is a shortcut available for those who wish to be able to edit the transport
  69   clocks entirely without the mouse. It can be found in
  70   <kbd class="menu">Window &gt; Key Bindings &gt; Transport &gt; Focus On
  71   Clock</kbd>. If bound to a key (<kbd>&divide;</kbd> on the numerical
  72   keypad is the
  73   default), then pressing that key is equivalent to clicking on the primary (left)
  74   transport clock, and editing can begin immediately.
  75 </p>
  76
  77 <h2>Entering Partial Times</h2>
  78
  79 <p>
  80   One detail of the editing design that is not immediately obvious is that it is
  81   possible to enter part of a full time value. Suppose that the clock is in BBT
  82   mode, displaying <samp>024|03|0029</samp>, and you want to alter the value to
  83   the first beat of the current bar. Click on the clock and type
  84   <kbd class="input">0 1 0 0 0 0</kbd>. Similarly, if it is in Minutes:Seconds
  85   mode, displaying <samp>02:03:04.456</samp>, and you want to get to exactly 2
  86   hours, click on the clock and type <kbd class="input">0 0 0 0 0 0 0</kbd> to
  87   reset the minutes, seconds and milliseconds fields.
  88 </p>
  89
  90 <h2>Entering Delta Times</h2>
  91
  92 <p>
  93   You can also type values into the clock that are intended as a relative change,
  94   rather than a new absolute value. Simply end the edit by pressing
  95   <kbd>+</kbd> or <kbd>-</kbd> (the ones on any keypad will also work). The plus
  96   key will add the entered value to the current value of the clock, minus will
  97   subtract it. For example, if the clock is in Samples mode and displays
  98   <samp>2917839</samp>, you move it back 2000 samples by typing
  99   <kbd class="input">2 0 0 0</kbd> and <kbd>-</kbd>, rather than ending with
 100   Enter or Tab.
 101 </p>
 102
 103 <h2>Changing clock values with the mouse</h2>
 104
 105 <h3>Using a scroll wheel</h3>
 106
 107 <p>
 108   Position the mouse pointer over the clock, and move the scroll wheel. Moving
 109   the scroll wheel up (<kbd class="mouse">&uArr;</kbd>) increases the value
 110   shown on the clock, moving it down  (<kbd class="mouse">&uArr;</kbd>)
 111   decreases it. The step size is equal to the unit of the field
 112   you are hovering over (seconds, hours, etc.).
 113 </p>
 114
 115 <h3>Dragging the mouse</h3>
 116
 117 <p>
 118   Position the mouse pointer over the clock, press the left mouse button and drag.
 119   Dragging upwards increases the value shown on the clock, dragging downwards
 120   decreases it, again with a step size equal to the unit of the field you
 121   began the drag on.
 122 </p>