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)
This commit is contained in:
Alexandre Prokoudine 2022-11-07 12:22:29 +03:00
parent 571efd9033
commit 45a7af9ada
6 changed files with 174 additions and 16 deletions

View File

@ -8,9 +8,9 @@
<p>
To create a new BBT marker, <kbd class="mod1n"></kbd>-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 <kbd class="window">New Music
Time</kbd> where you can name the marker and define what bar (left field) and
beat (right field) this marker should reset the time to.
</p>
<figure>

View File

@ -1,14 +1,25 @@
<p>
<dfn>Location Markers</dfn> appear in the <a href="@@ruler">Locations Markers
ruler</a> at the top of the timeline. The green
<dfn style="background-color:limegreen;">begin</dfn> and
<dfn style="background-color:limegreen;">end</dfn> markers, that define the length of the session, appear
automatically, but yellow <span style="background-color:gold;">custom</span> markers can be created at any position in a
session.
ruler</a> at the top of the timeline. They have multiple uses, most
commonly&nbsp;&mdash; 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.
</p>
<p>
There are multiple ways to create custom markers at the current playhead position:
The <dfn style="background-color:limegreen;">start</dfn> and
<dfn style="background-color:limegreen;">end</dfn> 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.
</p>
<h2>Creating Location Markers</h2>
<p>
There are multiple ways to create custom markers at the current playhead
position:
</p>
<ul>
<li>using the keyboard shortcut (default is <kbd>Tab</kbd></li>
@ -17,8 +28,8 @@
</ul>
<p>
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:
</p>
<ul>
<li><kbd class="mouse">right</kbd> clicking in the Location Marker ruler, and
@ -28,3 +39,124 @@
clock widget</a> to set its position.</li>
</ul>
<h2>Moving Location Markers</h2>
<p>
<kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
new location on the timeline.
</p>
<p>
It is possible to move multiple markers by the same distance. <kbd
class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
markers that can be dragged left or right together.
</p>
<h2>Renaming Location Markers</h2>
<p>
There are three ways to rename a location marker:
</p>
<ol>
<li>
Double-click on a marker opens a dialog where a new name can be submitted.
</li>
<li>
Right-clicking on a marker and selecting <kbd class="menu">Rename….</kbd>
opens a dialog where a new name can be submitted.
</li>
<li>
Editing and confirming the name by pressing <kbd class="button">Enter</kbd>
in an entry box in the <em>Ranges&nbsp;&amp; Marks</em> sidebar.
</li>
</ol>
<h2>Removing Location Markers</h2>
<p>
There are three ways to remove a location marker:
</p>
<ol>
<li>
Hovering the marker and pressing <kbd class="button">Enter</kbd>.
</li>
<li>
Right-clicking on a marker and selecting <kbd class="menu">Remove</kbd>.
</li>
<li>
Clicking the <kbd class="button">x</kbd> for a marker of choice in the
<em>Ranges&nbsp;&amp; Marks</em> sidebar.
</li>
</ol>
<h2>More Options</h2>
<p>
The context (right-click) menu for location markers has more options than the
ones mentioned above:
</p>
<table class="dl">
<tr>
<th>Locate to Here</th>
<td>
Moves the playhead to the selected marker.
</td>
</tr>
<tr>
<th>Play from Here</th>
<td>
Moves the playhead to the selected marker and starts playback.
</td>
</tr>
<tr>
<th>Move Mark to Playhead</th>
<td>
This changes the position of the selected marker to that of the playhead.
</td>
</tr>
<tr>
<th>Create Range to next Marker</th>
<td>
This creates a pair of range markers between the selected marker and the
next one to the right on the timeline.
</td>
</tr>
<tr>
<th>Promote to Time Origin</th>
<td>
This makes the position of the chosen range marker the origin time. This
is mostly useful when the <em>Display delta to origin marker</em> clock
mode is enabled to display the difference between current playhead
position and the origin time. Absolute time stays unaffected.
</td>
</tr>
<tr>
<th>Hide</th>
<td>
This hides the selected marker from the ruler until the user chooses to
unhide it.
</td>
</tr>
<tr>
<th>Rename…</th>
<td>
This opens a dialog to rename the marker.
</td>
</tr>
<tr>
<th>Lock</th>
<td>
This prevents a marker from being accidentally moved elsewhere.
</td>
</tr>
<tr>
<th>Glue to Bars and Beats</th>
<td>
When this option is enabled, the marker maintains its position in bars
and beats even if there are changes in tempo and meter.
</td>
</tr>
</table>

View File

@ -66,7 +66,7 @@
</li>
<li>
By clicking the markers' <kbd class="button">x</kbd> button in the
<em>Ranges &amp Marks</em> sidebar.
<em>Ranges&nbsp;&amp; Marks</em> sidebar.
</li>
</ol>

View File

@ -33,8 +33,29 @@
<h2>Moving Cue Markers</h2>
<p>
Just like any other marker, a cue marker can be picked and relocated by
dragging it left or right.
<kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
new location on the timeline.
</p>
<p>
It is possible to move multiple markers by the same distance. <kbd
class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
markers that can be dragged left or right together.
</p>
<h2>Single marker</h2>
<p>
<kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
new location on the timeline.
</p>
<h2>Multiple markers</h2>
<p>
It is possible to move multiple markers by the same distance. <kbd
class="mouse mod1">Left</kbd>-clicking each discreet marker, or <kbd
class="mouse mod3">Left</kbd>-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.
</p>
<h2>Stopping All Cues</h2>

View File

@ -130,7 +130,7 @@
<h2>Removing Markers</h2>
<p>
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
<kbd class="menu">Remove</kbd> in the menu.
</p>
@ -147,6 +147,11 @@
pointer, then press <kbd class="key">Del</kbd>.
</p>
<p>
The third way is to click the markers' <kbd class="button">x</kbd> button in
the <em>Ranges&nbsp;&amp; Marks</em> sidebar.
</p>
<h2>Additional Actions</h2>
<p>

View File

@ -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