From 8532880eadd825ebb4c775ad70fe06a201aedecb Mon Sep 17 00:00:00 2001 From: Ed Ward Date: Fri, 20 Jan 2017 10:52:51 +0100 Subject: [PATCH] Separation of the Times pages into Transport Clock, Editing Clocks & Selection and Punch Clocks --- .../08_editing-clocks.html} | 303 +----------------- .../01_main-menu/06_View-menu.html | 2 +- .../01_main-menu/07_Window-menu.html | 2 +- .../02_transport-clocks.html | 84 +++++ .../03_selection-and-punch-clocks.html | 30 ++ .../05_ranges-and-marks-list.html | 130 +------- _manual/06_controlling-playback.html | 2 +- .../01_creating-location-markers.html | 6 +- 8 files changed, 143 insertions(+), 416 deletions(-) rename _manual/{05_ardours-interface/03_transport-bar-and-times/02_times.html => 02_introducing-ardour/03_basic-gui-operations/08_editing-clocks.html} (51%) create mode 100644 _manual/05_ardours-interface/03_transport-bar-and-times/02_transport-clocks.html create mode 100644 _manual/05_ardours-interface/03_transport-bar-and-times/03_selection-and-punch-clocks.html diff --git a/_manual/05_ardours-interface/03_transport-bar-and-times/02_times.html b/_manual/02_introducing-ardour/03_basic-gui-operations/08_editing-clocks.html similarity index 51% rename from _manual/05_ardours-interface/03_transport-bar-and-times/02_times.html rename to _manual/02_introducing-ardour/03_basic-gui-operations/08_editing-clocks.html index bd88d31..22dded2 100644 --- a/_manual/05_ardours-interface/03_transport-bar-and-times/02_times.html +++ b/_manual/02_introducing-ardour/03_basic-gui-operations/08_editing-clocks.html @@ -1,401 +1,122 @@ --- -title: Times +layout: default +title: Editing Clocks --- - - - -

- - Clocks in Ardour are used to display time values precisely. - - In many cases, they are also one way to edit (change) time values, and in a few - - cases, the only way. All clocks share the same basic appearance and functionality, - - which is described below, but a few clocks serve particularly important roles. - -

- - - -

Transport Clocks

- - - -

- - In the transport bar of the editor window there are two clocks (unless you - - are on a very small screen), that display the current position of the playhead - - and additional information related to transport control and the timeline. These - - are called the transport clocks; the left one is the primary - - transport clock and the right one is the secondary transport clock. - - They look like this: - -

- - - -An image of the transport clocks in Ardour - - - -

- - Editing the time in the transport clocks will reposition the playhead in the same - - way that various other editing operations will. - -

- - - -

The Big Clock

- -

- - To show the current playhead position in a big, resizable window, activate - - Window > Big Clock. The big clock is very useful - - when you need to work away from the screen but still want to see the playhead - - position clearly (such as when working with a remote control device across - - a room). The big clock will change its visual appearance to indicate when active - - recording is taking place. Below on the left is a screenshot showing a fairly - - large big clock window filling a good part of the display, and on the right, - - the same clock during active recording. - -

- -an image of the big clock filling a screen an image of the big clock while recording - - - -

The Special Role of the Secondary Transport Clock

- -

- - On a few occasions Ardour needs to display time values to the user, but there - - is no obvious way to specify what units to use. The most common case is the big - - cursor that appears when dragging regions. For this and other similar cases, - - Ardour will display time using the same units as the secondary clock. - -

- -

Why are there two transport clocks?

- -

- - Having two transport clocks lets you see the playhead position in two different - - time units without having to change any settings. For example, you can see the - - playhead position in both timecode units and BBT time. - -

- - - -

Selection and Punch Clocks

- -

- - The transport bar also contains a set of 5 clocks that show the current - - selection range and punch ranges. Clicking on the punch - - range clocks will locate to either the beginning or end of the punch range. - - Similarly, clicking on the range clocks will locate to either the beginning - - or end of the current selection. In this screen shot there is no current - - selection range, so the selection clocks show an "off" state. - -

- - - -An image of the the selection and punch clocks in Ardour 3 - - -

Clock Modes

- Every clock in Ardour has four different, selectable clock - modes. Each mode displays time using different units. - You can change the clock mode by Right-clicking - on the clock and selecting the desired mode from the menu. Some clocks are - entirely independent of any other clock's mode; others are linked so that - changing one changes all clocks in that group. The different modes are: -

- -
Timecode
- -
Time is shown as SMPTE timecode in Hours:Minutes:Seconds:Frames, - measured from the timecode zero point on the timeline (which may not - correspond to the session start and/or absolute zero on the timeline, - depending on configurable timecode offsets). - The frames value is dictated by either the session FPS setting, or, if slaved to an external timecode master, - the master's setting. In the transport clocks, the FPS value is shown below - the time display, along with an indication of the current timecode source - (INT means that Ardour is its own timecode source).
- -
BBT
- -
Time is shown as Bars:Beats:Ticks, indicating musical time measured - +
BBT
Time is shown as Bars:Beats:Ticks, indicating musical time measured from the start of the session. The transport clocks show the current tempo - in bpm and meter below the time - display.
- -
Minutes:Seconds
- -
Time is shown as Hours:Minutes:Seconds.Milliseconds, measured from the - +
Minutes:Seconds
Time is shown as Hours:Minutes:Seconds.Milliseconds, measured from the absolute start of the timeline (ignoring the session start and any timecode - offsets).
- -
Samples
- -
Time is shown as a sample count from the absolute start of the timeline - +
Samples
Time is shown as a sample count from the absolute start of the timeline (ignoring the session start and any timecode offsets). The number of - samples per second is given by the current sample rate, and in the transport - clocks, this rate is shown below the time display along with any - pullup/pulldown adjustment.
-
- - -

Special Modes for the Transport Clocks

- -

- - In addition to the time-unit modes mentioned above, each of the two transport - - clocks (if you work on a small screen, you may only have one) can be - - independently set to display Delta to Edit Point in whatever time - - units its current mode indicates. This setting means that the clock shows the - - distance between the playhead and the current edit point, and it may show a - - positive or negative value depending on the temporal order of these two points. - - The clocks will use a different color when in this mode to avoid confusion. - -

- -

- - To switch either (or both!) of the transport clocks into this mode, use - - Edit > Preferences > Transport and select - - the relevant checkboxes. - -

- -

- - Note that when in Delta to Edit Point mode, the transport clocks - - cannot be edited. - -

- - -

Changing clock values with the keyboard

- New values for the clock can be typed in after clicking on the relevant clock. - Clicking on the clock will show a thin vertical cursor bar just to the right - of the next character to be overwritten. Enter time in the same order as the - current clock mode—if the clock is in Timecode mode, you need to enter - hours, minutes, seconds, frames. So, to change to a time of 12:15:20:15 you - would type 1 2 1 5 2 0 1 5. Each number you type will - appear in a different color, from right to left, overwriting the existing value. - Mid-edit, after typing 3 2 2 2 the clock might look like this: -

-An image of a clock being edited in Ardour 3 +An image of a clock being edited in Ardour

- To finish the edit, press ↵ or Tab. To exit an - edit without changing the clock press ESC. If you mis-type an entry - so that the new value would be illegal (for example, resulting in more than 30 - frames when Timecode is set to 30 frames per second), the clock will reset at - the end of the edit, and move the cursor back to the start so that you can - start over. -

- - -

Avoiding the mouse entirely

+

Avoiding the mouse entirely

- There is a shortcut available for those who wish to be able to edit the transport - clocks entirely without the mouse. It can be found in - Window > Key Bindings > Transport > Focus On - Clock. If bound to a key (÷ on the numerical - keypad is the - default), then pressing that key is equivalent to clicking on the primary (left) - transport clock, and editing can begin immediately. -

- - -

Entering Partial Times

+

Entering Partial Times

- One detail of the editing design that is not immediately obvious is that it is - possible to enter part of a full time value. Suppose that the clock is in BBT - mode, displaying 024|03|0029, and you want to alter the value to - the first beat of the current bar. Click on the clock and type - 0 1 0 0 0 0. Similarly, if it is in Minutes:Seconds - mode, displaying 02:03:04.456, and you want to get to exactly 2 - hours, click on the clock and type 0 0 0 0 0 0 0 to - reset the minutes, seconds and milliseconds fields. -

- - -

Entering Delta Times

+

Entering Delta Times

- You can also type values into the clock that are intended as a relative change, - rather than a new absolute value. Simply end the edit by pressing - + or - (the ones on any keypad will also work). The plus - key will add the entered value to the current value of the clock, minus will - subtract it. For example, if the clock is in Samples mode and displays - 2917839, you move it back 2000 samples by typing - 2 0 0 0 and -, rather than ending with - - Enter or Tab.

- - + Enter or Tab. +

Changing clock values with the mouse

- -

Using a scroll wheel

- -

- Position the mouse pointer over the clock, and move the scroll wheel. Moving - the scroll wheel up (⇑) increases the value - shown on the clock, moving it down (⇑) - decreases it. The step size is equal to the unit of the field - you are hovering over (seconds, hours, etc.). -

- -

Dragging the mouse

- -

- Position the mouse pointer over the clock, press the left mouse button and drag. - Dragging upwards increases the value shown on the clock, dragging downwards - decreases it, again with a step size equal to the unit of the field you - began the drag on. -

diff --git a/_manual/05_ardours-interface/01_main-menu/06_View-menu.html b/_manual/05_ardours-interface/01_main-menu/06_View-menu.html index aedd8d0..5a19936 100644 --- a/_manual/05_ardours-interface/01_main-menu/06_View-menu.html +++ b/_manual/05_ardours-interface/01_main-menu/06_View-menu.html @@ -11,7 +11,7 @@ title: The View Menu
[] Maximize Mixer Space
Puts the Mixer window in full screen mode
Primary Clock
-
Focus On Clock
Sets the focus on the main clock, allowing to type in numbers directly to change the playhead position
+
Focus On Clock
Sets the focus on the main clock, allowing to type in numbers directly to change the playhead position
Timecode
Sets the main clock in timecode mode, so it displays time in the Hours:Minutes:Seconds:Frames format
Bars & Beats
Sets the main clock in musical time mode, so it displays time in the Bars:Beats:Ticks format
Minutes & Seconds
Sets the main clock in absolute time mode, so it displays time in the Hours:Minutes:Seconds.Milliseconds format
diff --git a/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html b/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html index a416d1d..e00917f 100644 --- a/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html +++ b/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html @@ -25,7 +25,7 @@ title: The Window Menu
[] Locations
Opens the Ranges and Marks window, a single point of control for all range and location markers
[] Binding Editor
Opens the Key Bindings window, which allows for easy creation or modification of any keyboard shortcut
[] Bundle Manager
Opens the Bundle Manager window, allowing to create and manage Bundles, which are a way to simplify connection management, by defining groups of ports
-
[] Big Clock
Opens the Main Clock as its own separate (and huge) window, which is helpfull when recording
+
[] Big Clock
Opens the Main Clock as its own separate (and huge) window, which is helpfull when recording
[] Video Monitor
If a video has been imported in the session, opens a video window (namely, Xjadeo), synced to the timeline
diff --git a/_manual/05_ardours-interface/03_transport-bar-and-times/02_transport-clocks.html b/_manual/05_ardours-interface/03_transport-bar-and-times/02_transport-clocks.html new file mode 100644 index 0000000..647864e --- /dev/null +++ b/_manual/05_ardours-interface/03_transport-bar-and-times/02_transport-clocks.html @@ -0,0 +1,84 @@ +--- +title: The Transport Clocks +--- + +An image of the transport clocks in Ardour + +

+ Clocks in Ardour are used to display time values precisely. + In many cases, they are also one way to edit (change) time values, and in a few + cases, the only way. All clocks share the same basic appearance and functionality, + which is described below, but a few clocks serve particularly important roles. +

+

+ In the transport bar of the editor window there are two clocks (unless you + are on a very small screen), that display the current position of the playhead + and additional information related to transport control and the timeline. These + are called the transport clocks; the left one is the primary + transport clock and the right one is the secondary transport clock. +

+

+ All the clocks in Ardour share the same powerfull way of editing time. Refer to + Editing Clocks to learn how. +

+

+ Editing the time in the transport clocks will reposition the playhead in the same + way that various other editing operations will. +

+ +

The Special Role of the Secondary Transport Clock

+ +

+ On a few occasions Ardour needs to display time values to the user, but there + is no obvious way to specify what units to use. The most common case is the big + cursor that appears when dragging regions. For this and other similar cases, + Ardour will display time using the same units as the secondary clock. +

+ +

Why are there two transport clocks?

+ +

+ Having two transport clocks lets you see the playhead position in two different + time units without having to change any settings. For example, you can see the + playhead position in both timecode units and BBT time. +

+ +

Special Modes for the Transport Clocks

+ +

+ In addition to the time-unit modes, each of the two transport + clocks (if you work on a small screen, you may only have one) can be + independently set to display Delta to Edit Point in whatever time + units its current mode indicates. This setting means that the clock shows the + distance between the playhead and the current edit point, and it may show a + positive or negative value depending on the temporal order of these two points. + The clocks will use a different color when in this mode to avoid confusion. +

+ +

+ To switch either (or both!) of the transport clocks into this mode, use + Edit > Preferences > Transport and select + the relevant checkboxes. +

+ +

+ Note that when in Delta to Edit Point mode, the transport clocks + cannot be edited. +

+ + +

The Big Clock

+ +

+ To show the current playhead position in a big, resizable window, activate + Window > Big Clock. The big clock is very useful + when you need to work away from the screen but still want to see the playhead + position clearly (such as when working with a remote control device across + a room). The big clock will change its visual appearance to indicate when active + recording is taking place. Below on the left is a screenshot showing a fairly + large big clock window filling a good part of the display, and on the right, + the same clock during active recording. +

+ +an image of the big clock filling a screen +an image of the big clock while recording diff --git a/_manual/05_ardours-interface/03_transport-bar-and-times/03_selection-and-punch-clocks.html b/_manual/05_ardours-interface/03_transport-bar-and-times/03_selection-and-punch-clocks.html new file mode 100644 index 0000000..d898777 --- /dev/null +++ b/_manual/05_ardours-interface/03_transport-bar-and-times/03_selection-and-punch-clocks.html @@ -0,0 +1,30 @@ +--- +title: Selection and Punch Clocks +--- + +An image of the the selection and punch clocks in Ardour + +

+ The transport bar contains a set of 5 clocks that show the current + selection range and punch ranges. +

+

+ Clicking on the punch range clocks will locate to either the beginning or end of the punch range. + Similarly, clicking on the range clocks will locate to either the beginning + or end of the current selection. In this screen shot there is no current + selection range, so the selection clocks show an "off" state. +

+

+ The In and Out buttons relate + to the Punch range, and allow to use only one of the two punch boundaries, or both: +

+
+
In only
Records from the In marker on, without a end boundary
+
Out only
Records untils the Out marker, without a beginning boundary
+
In only
Records only between the In and Out markers
+
+

+ Right clicking on any of the 5 clocks brings up a context menu + allowing to change the type of time display between the + 4 clock modes, and to copy the selected clock's time to the clipboard. +

diff --git a/_manual/05_ardours-interface/04_the-editor/03_the-editor_s-lists/05_ranges-and-marks-list.html b/_manual/05_ardours-interface/04_the-editor/03_the-editor_s-lists/05_ranges-and-marks-list.html index ad19d57..03083c2 100644 --- a/_manual/05_ardours-interface/04_the-editor/03_the-editor_s-lists/05_ranges-and-marks-list.html +++ b/_manual/05_ardours-interface/04_the-editor/03_the-editor_s-lists/05_ranges-and-marks-list.html @@ -2,179 +2,73 @@ title: Ranges and Marks List --- - -

- The Ranges & Marks List is a tab in the Editor - Lists area on the right of the Editor window. If the editor - list area isn't visible it can be enabled by checking - View > Show Editor List. - The Ranges & Marks list can be used as a single point - of control for all range and location markers (including the punch and - loop ranges), or as a supplement to other methods of working with them. -

- -

Common elements

- -

- Each section has a set of editable clock widgets - - which display - - the location of a marker, or the start, end, and duration times of a range, - - respectively.
- + href="/introducing-ardour/basic-gui-operations/editing-clocks/">clock widgets + which display the location of a marker, or the start, end, and duration times of a range, + respectively. +

+

The Use PH buttons allow you to set - the corresponding clock to the current playhead position. - A Middle click on any of the clocks will move - the playhead to that location. Both functions are also available from the - - clock context menus.
- + clock context menus. +

+

Right clicking on any of the clocks brings up a context menu that allows - changing of the display between Timecode, Bars:Beats, Minutes:Seconds, - - and Samples.
- + and Samples.

-

- The — (subtract) button in front of each - user-defined range or marker in the list allows that particular item to - be removed. The name fields of custom ranges and markers can be edited. -

-

- The Hide checkboxes make markers and ranges invisible - on the respective ruler to reduce visual clutter; the markers remain - - active however, and can be used normally.
- + active however, and can be used normally. +

+

Selecting Lock prevents the respective marker - from being moved until unlocked. - Where applicable, Glue fixes the marker position - relative to the current musical position expressed in bars and beats, rather - than the absolute time. This will make the respective marker follow - changes in the tempo map. -

-

- At the bottom of the list are buttons to add new markers or ranges. -

List sections

- -
-
Loop/Punch Ranges
-
This list shows the current loop and punch range - settings. Since these are built-in ranges, you cannot rename or remove them.
-
Markers (Including CD Index)
-
This section lists the session's markers. By ticking CD, you instruct Ardour to create a CD track - index from this marker, which will be included in the TOC or CUE file when you - export.
-
Ranges (Including CD Track Ranges)
-
This is the list of ranges (including CD track - ranges). Ticking CD will convert - the range to a CD track, which will again be included in - exported TOC or CUE files. This is relevant for Disk-At-Once recordings - that may contain audio data between tracks.
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/_manual/06_controlling-playback.html b/_manual/06_controlling-playback.html index d2a65e3..e054475 100644 --- a/_manual/06_controlling-playback.html +++ b/_manual/06_controlling-playback.html @@ -25,7 +25,7 @@ title: Controlling Playback

Positioning the playhead with the transport clocks

Click on either the primary or secondary transport clock and - edit their value + edit their value to move the playhead to a specific position.

diff --git a/_manual/07_working-with-markers/01_creating-location-markers.html b/_manual/07_working-with-markers/01_creating-location-markers.html index c002d07..ccfc70f 100644 --- a/_manual/07_working-with-markers/01_creating-location-markers.html +++ b/_manual/07_working-with-markers/01_creating-location-markers.html @@ -24,8 +24,6 @@ title: Creating Location Markers

For details see - Ranges & Marks - List - and Using - Ardour Clock Displays. + Ranges & Marks List + and Editing Clocks.

-- 2.37.2