From: Alexandre Prokoudine Date: Mon, 10 Oct 2022 19:54:46 +0000 (+0300) Subject: Ruler/Markers rewrite, part 2 of N X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=06dceb6114f838b264674e629937339920f1ee16 Ruler/Markers rewrite, part 2 of N Also add various screenshots --- diff --git a/include/ruler.html b/include/ruler.html index b2b08ec..b34e9c6 100644 --- a/include/ruler.html +++ b/include/ruler.html @@ -25,7 +25,7 @@ - + @@ -37,7 +37,7 @@ - + @@ -54,11 +54,11 @@ The Bars:Beats ruler will reflect the change. - + - + @@ -68,16 +68,16 @@ to be split in time, as an audio CD - - - - - + - + + + + + diff --git a/include/working-with-markers.html b/include/working-with-markers.html index 23322ec..6ec4eb7 100644 --- a/include/working-with-markers.html +++ b/include/working-with-markers.html @@ -1,47 +1,157 @@ +

+ Ardour supports multiple type of markers, all designed for particular tasks: + single markers that define a location, single markers that change a value, + paired markers that define a range on a timeline etc. +

+ +

Creating New Markers

+ +

+ There are several ways to create markers in Ardour. +

+ +

+ The most common way is to right-click over a ruler and select a menu item + called like New Loop Range (for the + Loop/Punch Ranges ruler) or + New Tempo (for the + Tempo ruler). +

+ +
+ Adding a New Range Marker +
+ Adding a New Range Marker +
+
+ +

+ Some of the markers can be created from context menus on the canvas. + E.g. range markers can be created by creating a range, opening the context + (right-click) menu and choosing Add Range Markers. +

+ +

+ Additionally, location markers and range markers can be created from the + Ranges & Marks sidebar by clicking + Ranges & Marks or + Ranges & Marks respectively. +

+ +

Moving Markers

+ +

+ Once a single or a paired marker has been added, it can be moved around. +

+ +

Single marker

+

+ Left-clicking and dragging moves a single marker to a + new location on the timeline. +

+ +

+ Additionally, markers can be moved to playhead position by right-clicking and + choosing the Move Mark to Playhead menu item. +

+ +

Multiple markers

+

+ It is possible to move multiple markers by the same distance. Left-clicking each discreet marker, or Left-clicking the first and last markers of a range + of markers selects them, then dragging one to a new location will move all + selected markers together. +

+

+ The markers are bounded by the zero point on the timeline. In other words, the + first marker in the selection cannot move to the left of zero on the timeline. +

+ +

Both ends of a range marker

+

+ By left-dragging either end of the range marker, + the other end will move by the same distance. +

+ +

Renaming Markers

+ +

+ Some markers on the ruler can have unique names: location markers, CD markers, + range markers. Double-clicking on them opens a dialog where a different name + can be submitted. +

+ +
+ Renaming a Marker +
+ Renaming a Marker +
+
+ +

+ Alternatively, right-clicking on a marker will open a context menu with a menu + item called Rename... or + Rename Range..., depending on the type of the marker. + The same dialog for submitting a new name will appear. +

+ +

Editing Marker's Properties

+ +

+ Markers on rulers such as Time Signature or + Tempo don't have unique names, however they do have + other properties that can be edited. The principle is the same as with + renaming: double-clicking on a marker or right-clicking and choosing the + Edit... menu item. +

+ +

Hiding Markers

- It is very useful to be able to tag different locations in a session for - later use when editing and mixing. Ardour supports both - locations, which define specific positions in time, - and ranges which define a start and end position in time. -

-

- In addition to the standard location markers, there are several more kinds of - special markers: -

- + Most marker types can be temporarily hidden from the ruler if the user chooses + to do so. The user interface for that is available in the + Ranges & Marks sidebar: it is a simple + Hide checkbox for each marker. +

+
+ Hiding Markers +
+ Hiding Markers +
+
+ +

+ Clicking the respective Hide checkbox again will + reveal the marker on the ruler again. +

+ +

Removing Markers

+ +

+ There are two ways to permanently delete a marker. The first one is to + right-click the marker of choice, then select + Remove in the menu. +

+ +
+ Removing a Location Marker +
+ Removing a Location Marker +
+
+ +

+ The second one is to click a marker to select it, keep hovering the mouse + pointer, then press Del. +

+ +

Additional Actions

+ +

+ Depending on the type of a marker additional actions are possible, such as + moving the playhead to a location marker's position or zooming to a range + saved with range markers. This is covered in dedicated subchapters for + respective ruler/marker types. +

diff --git a/source/images/gain-cut-example.png b/source/images/gain-cut-example.png new file mode 100644 index 0000000..06fc5e3 Binary files /dev/null and b/source/images/gain-cut-example.png differ diff --git a/source/images/new-range-markers.gif b/source/images/new-range-markers.gif new file mode 100644 index 0000000..893379f Binary files /dev/null and b/source/images/new-range-markers.gif differ diff --git a/source/images/normalize-region-settings.png b/source/images/normalize-region-settings.png new file mode 100644 index 0000000..6326d45 Binary files /dev/null and b/source/images/normalize-region-settings.png differ diff --git a/source/images/region-properties-gain-adjusted.png b/source/images/region-properties-gain-adjusted.png new file mode 100644 index 0000000..9beb027 Binary files /dev/null and b/source/images/region-properties-gain-adjusted.png differ diff --git a/source/images/regions-and-marks.png b/source/images/regions-and-marks.png new file mode 100644 index 0000000..330e6a4 Binary files /dev/null and b/source/images/regions-and-marks.png differ diff --git a/source/images/remove-a-marker.png b/source/images/remove-a-marker.png new file mode 100644 index 0000000..9f9527d Binary files /dev/null and b/source/images/remove-a-marker.png differ diff --git a/source/images/renaming-a-marker.gif b/source/images/renaming-a-marker.gif new file mode 100644 index 0000000..17db0f4 Binary files /dev/null and b/source/images/renaming-a-marker.gif differ diff --git a/source/images/trigger-slot-playing.png b/source/images/trigger-slot-playing.png new file mode 100644 index 0000000..36fb61f Binary files /dev/null and b/source/images/trigger-slot-playing.png differ diff --git a/source/images/virtual-piano-keyboard-map.png b/source/images/virtual-piano-keyboard-map.png new file mode 100644 index 0000000..2599432 Binary files /dev/null and b/source/images/virtual-piano-keyboard-map.png differ
Mins:SecMins:Secs scaling the session with the Mins:Secs:mSec notation
scaling the session with the sample number notation
Bars & BeatsBars:Beats slicing the time according to the time signature
RangesRange Markers allow to create and modify ranges directly on the Ruler.
Loop/PunchLoop/Punch Ranges are special kind of ranges designed to be played as a loop and to do punch recording, i.e. recording on a precise section of time, respectively.
Cue markersallows triggering entire cues from the grid in the Cuewindow
MarkersLocation Markers is meant to receive any kind of marker, user generated or from Ardour itself.
VideoCue Markersallows triggering entire cues from the grid in the Cuewindow
Video Timeline shows thumbnails of the video in the timeline