From 45a7af9adad19e60f15cf0c17a3926d8c48c77f2 Mon Sep 17 00:00:00 2001 From: Alexandre Prokoudine Date: Mon, 7 Nov 2022 12:22:29 +0300 Subject: [PATCH] Ruler/Markers rewrite, part 5 of N - Rewrite Location Markers - Update documentation on some other marker types - Update TOC/menu to stop listing outdated pages (they are still built) --- include/bbt-markers.html | 6 +- include/creating-location-markers.html | 148 +++++++++++++++++++++++-- include/creating-range-markers.html | 2 +- include/cue-markers.html | 25 ++++- include/working-with-markers.html | 7 +- master-doc.txt | 2 +- 6 files changed, 174 insertions(+), 16 deletions(-) diff --git a/include/bbt-markers.html b/include/bbt-markers.html index d8cbf42..0bb3553 100644 --- a/include/bbt-markers.html +++ b/include/bbt-markers.html @@ -8,9 +8,9 @@

To create a new BBT marker, -click on the - Bars:Beats ruler. This will open a dialog titled 'New Music Time' where you - can name the marker and define what bar (left field) and beat (right field) - this marker should reset the time to. + Bars:Beats ruler. This will open a dialog titled New Music + Time where you can name the marker and define what bar (left field) and + beat (right field) this marker should reset the time to.

diff --git a/include/creating-location-markers.html b/include/creating-location-markers.html index 1064ff1..62daa83 100644 --- a/include/creating-location-markers.html +++ b/include/creating-location-markers.html @@ -1,14 +1,25 @@

Location Markers appear in the Locations Markers - ruler at the top of the timeline. The green - begin and - end markers, that define the length of the session, appear - automatically, but yellow custom markers can be created at any position in a - session. + ruler at the top of the timeline. They have multiple uses, most + commonly — for navigation in a session, e.g. where this or that + instrument should start/stop playing. Custom markers can be created at + any position in a session.

+

- There are multiple ways to create custom markers at the current playhead position: + The start and + end markers, that define the + length of the session, appear automatically once any content has been added to + the session (either recorded or imported). The end marker automatically shifts + to the right once more material gets added. +

+ +

Creating Location Markers

+ +

+ There are multiple ways to create custom markers at the current playhead + position:

- Adding a marker at an arbitrary location on the timeline (i.e. not at the playhead - position) can also be done either by: + Adding a marker at an arbitrary location on the timeline (i.e. not at the + playhead position) can also be done either by:

+

Moving Location Markers

+ +

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

+ +

+ It is possible to move multiple markers by the same distance. Left-clicking each marker creates a selection of + markers that can be dragged left or right together. +

+ +

Renaming Location Markers

+ +

+ There are three ways to rename a location marker: +

+ +
    +
  1. + Double-click on a marker opens a dialog where a new name can be submitted. +
    2. +
  2. + Right-clicking on a marker and selecting Rename…. + opens a dialog where a new name can be submitted. +
    3. +
  3. + Editing and confirming the name by pressing Enter + in an entry box in the Ranges & Marks sidebar. +
    4. +
+ +

Removing Location Markers

+ +

+ There are three ways to remove a location marker: +

+ +
    +
  1. + Hovering the marker and pressing Enter. +
    2. +
  2. + Right-clicking on a marker and selecting Remove. +
    3. +
  3. + Clicking the x for a marker of choice in the + Ranges & Marks sidebar. +
    4. +
+ +

More Options

+ +

+ The context (right-click) menu for location markers has more options than the + ones mentioned above: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Locate to Here + Moves the playhead to the selected marker. +
Play from Here + Moves the playhead to the selected marker and starts playback. +
Move Mark to Playhead + This changes the position of the selected marker to that of the playhead. +
Create Range to next Marker + This creates a pair of range markers between the selected marker and the + next one to the right on the timeline. +
Promote to Time Origin + This makes the position of the chosen range marker the origin time. This + is mostly useful when the Display delta to origin marker clock + mode is enabled to display the difference between current playhead + position and the origin time. Absolute time stays unaffected. +
Hide + This hides the selected marker from the ruler until the user chooses to + unhide it. +
Rename… + This opens a dialog to rename the marker. +
Lock + This prevents a marker from being accidentally moved elsewhere. +
Glue to Bars and Beats + When this option is enabled, the marker maintains its position in bars + and beats even if there are changes in tempo and meter. +
diff --git a/include/creating-range-markers.html b/include/creating-range-markers.html index e7ae8ea..112f51b 100644 --- a/include/creating-range-markers.html +++ b/include/creating-range-markers.html @@ -66,7 +66,7 @@
  • By clicking the markers' x button in the - Ranges & Marks sidebar. + Ranges & Marks sidebar.
    • diff --git a/include/cue-markers.html b/include/cue-markers.html index a53a972..8b35831 100644 --- a/include/cue-markers.html +++ b/include/cue-markers.html @@ -33,8 +33,29 @@

    Moving Cue Markers

    - Just like any other marker, a cue marker can be picked and relocated by - dragging it left or right. + Left-clicking and dragging moves a single marker to a + new location on the timeline. +

    + +

    + It is possible to move multiple markers by the same distance. Left-clicking each marker creates a selection of + markers that can be dragged left or right together. +

    + +

    Single marker

    +

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

    + +

    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.

    Stopping All Cues

    diff --git a/include/working-with-markers.html b/include/working-with-markers.html index 6ec4eb7..ddc2af2 100644 --- a/include/working-with-markers.html +++ b/include/working-with-markers.html @@ -130,7 +130,7 @@

    Removing Markers

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

    @@ -147,6 +147,11 @@ pointer, then press Del.

    +

    + The third way is to click the markers' x button in + the Ranges & Marks sidebar. +

    +

    Additional Actions

    diff --git a/master-doc.txt b/master-doc.txt index bd198fa..c2f3d80 100644 --- a/master-doc.txt +++ b/master-doc.txt @@ -520,7 +520,7 @@ part: subchapter --- --- -title: Working With Markers +title: Markers Basics include: working-with-markers.html link: working-with-markers uri: working-with-markers -- 2.37.2