Documenting Track > Insert time/Remove Time

include/insert-remove-time.html

@@ -0,0 +1,81 @@
+
+<h2>Insert Time</h2>
+
+<figure>
+  <img src="/images/insert-time.png" alt="The Insert Time window">
+  <figcaption>
+    The Insert Time window
+  </figcaption>
+</figure>
+
+<p>
+  The <dfn>Insert Time</dfn> window allows to insert blank space in the timeline,
+  on the selected track(s). It is accessed through the <kbd class="menu">Track
+   &gt; Insert Time</kbd> menu.
+</p>
+<p>
+  The Insert Time window not only allows to set the time inserted, but also some fine tuning options:
+</p>
+
+<dl>
+  <dt>Insert Time starting at:</dt>
+    <dd>Sets the point in the session where the time will be added. By default, it is the playhead's position</dd>
+  <dt>Time to insert:</dt>
+    <dd>Duration of the blank space inserted</dd>
+  <dt>Inserted regions should:</dt>
+    <dd>A choice as to what happens to regions that exists at the Insert Time set above. See below.</dd>
+  <dt>Apply to all the track's playlists</dt>
+    <dd>As a track can have multiple <a href="@@understanding-playlists">playlists</a>, the insertion can happen either only on the active playlist or on all the plylists of this track</dd>
+  <dt>Move glued-to-musical-time regions (MIDI regions)</dt>
+    <dd>Defines if MIDI regions in selected tracks are affected by the operation</dd>
+  <dt>Move markers</dt>
+    <dd>As a <a href="@@working-with-markers">marker</a> can be <kbd class="option">locked</kbd> or <kbd class="option">glued to bars/beats</kbd>, this option and the two subjascent ones allow to shift the time position of those markers</dd>
+  <dt>Move tempo and meter changes</dt>
+    <dd>The <a href="@@tempo-and-meter">tempo and meter</a> markers, that can be used to change the tempo along the session, can also be shifted in the process. Though, moving the tempo markers while e.g. keeping the MIDI regions unaffected can create oddities.</dd>
+</dl>
+
+<p>
+  Both the two time fields have a useful context menu, that allows to copy/paste
+  the time and change the display among one of the <a href="@@editing-clocks">clock
+  modes</a>. The Insert Time field also has two options to <kbd class="menu">Set
+  from Playhead</kbd> (to get the insertion time from the playhead, which is what
+  happens by default) and <kbd class="menu">Locate to This Time</kbd> which moves
+  the playhead to the time field value, useful if the field has been manually edited
+  to better visualize the insertion point.
+</p>
+
+<p>
+  By default, inserting time only results in shifting positions of the regions
+  beginning <em>after</em> the insertion point. The "Inserted regions should" dropdown
+  menu allows to choose what happens to the regions that exist at the insertion time :
+</p>
+
+<dl>
+  <dt><dfn>stay in position</dfn> <em>(default)</em></dt><dd>The crossed regions are not affected by the time insertion</dd>
+  <dt><dfn>move</dfn></dt><dd>The crossed regions are shifted in time</dd>
+  <dt><dfn>be split</dfn></dt><dd>The crossed regions are split, and the section that is after the time insertion point are shifted in time</dd>
+</dl>
+
+<p>
+  This last mode allows a <em>brute force</em> insertion, creating a blank space
+  in all the selected tracks, and replacing multiple operations.
+</p>
+
+<p class="note">
+  Note: One interesting option is, if a range selection (created with in <a href="@@toolbox">
+  Range Mode</a>) exists, it is used as the default parameters in the window, instead
+  of the playhead, for both the start time and duration.
+</p>
+
+
+<h2>Remove Time</h2>
+
+<p>
+  The <dfn>Remove Time</dfn> window, accessed through the <kbd class="menu">Track
+   &gt; Remove Time</kbd> menu, is very similar to the previous, and its options
+   are very similar. Only the <em>"Inserted regions should"</em> option is not present
+</p>
+
+<p>
+  The range selection note above can be especially useful in this context.
+</p>

include/tempo-and-meter.html

@@ -38,7 +38,7 @@
 </p>
 
 <p>
-  A tempo may be remped or constant.
+  A tempo may be ramped or constant.
 </p>
 
 <ul>

master-doc.txt

@@ -1431,6 +1431,13 @@ uri: editing-and-arranging/strip-silence-from-audio-regions
 part: subchapter
 ---
 
+---
+title: Insert/Remove Time
+include: insert-remove-time.html
+link: insert-remove-time
+part: subchapter
+---
+
 ---
 title: Fades and Crossfades
 include: create-region-fades-and-crossfades.html