]> Shamusworld >> Repos - ardour-manual-diverged/commitdiff
Documenting the Transport Bar and modifying the CSS for prettier checkboxes
authorEd Ward <edwsaintesprit@hotmail.com>
Fri, 6 Jan 2017 18:28:33 +0000 (19:28 +0100)
committerPaul Davis <paul@linuxaudiosystems.com>
Tue, 10 Jan 2017 10:35:19 +0000 (10:35 +0000)
14 files changed:
_manual/04_ardours-interface.html
_manual/05_controlling-playback.html
_manual/05_controlling-playback/01_using-the-transport-bar.html [new file with mode: 0644]
_manual/05_controlling-playback/02_looping-the-transport.html [moved from _manual/05_controlling-playback/01_looping-the-transport.html with 100% similarity]
_manual/05_controlling-playback/03_positioning-the-playhead.html [moved from _manual/05_controlling-playback/02_positioning-the-playhead.html with 100% similarity]
_manual/05_controlling-playback/04_using-key-bindings.html [moved from _manual/05_controlling-playback/03_using-key-bindings.html with 100% similarity]
_manual/05_controlling-playback/05_using-the-nudge-controls.html [moved from _manual/05_controlling-playback/04_using-the-nudge-controls.html with 100% similarity]
_manual/05_controlling-playback/05_using-the-transport-bar.html [deleted file]
_manual/25_tempo-meter/01_tempo-and-meter.html
source/css/app.css
source/images/checkbox-checked.png [new file with mode: 0644]
source/images/checkbox-unchecked.png [new file with mode: 0644]
source/images/transport-bar.png [new file with mode: 0644]
source/images/transport.png [new file with mode: 0644]

index 68ca3d1c4e1ce4d3237fb4d347b975374d1cf355..637882e24faf0b939b2d59a7cedf6142bfd45e49 100644 (file)
@@ -5,10 +5,16 @@ title: Ardour's Interface
   
 <p>
   In Ardour, you work in two main windows: the <dfn>Editor</dfn> and the
-  <dfn>Mixer</dfn>.
+  <dfn>Mixer</dfn>. 
 </p>
 <img class="right" src="/diagrams/editor-summary.png" 
 alt="Ardour's editor window" />
+<p>
+  To switch between those windows, use the buttons (in the upper right), 
+  the shortcut <kbd class="mod2">M</kbd>, or the menu 
+  <kbd class="menu">Window > Editor <em>(or Mixer)</em> > Show</kbd>. 
+  Both windows can be visible at the same time (eg. for a multi-monitor 
+  setup) using <kbd class="menu">Detach</kbd> in the same menu.</p>
 <p>
   The <dfn>Editor</dfn> window includes the editor track <dfn>canvas</dfn>
   where you can arrange audio and MIDI data along a timeline. This is the 
index aef84cd39599cf7dea682bf8ee146f73d2c5fa69..78662486cde4690818c29c184fd24e1231c8d26e 100644 (file)
@@ -9,6 +9,10 @@ title: Controlling Playback
   You can also use markers to define locations or ranges within 
   the session and rapidly move around between them. 
 </p>
+
+<img src="/images/transport-bar.png" 
+alt="Ardour's transport bar" />
+
 <p class="note">
   If you synchronize Ardour with other devices then some or 
   all of these control methods may be unavailable &mdash; depending on 
@@ -16,4 +20,21 @@ title: Controlling Playback
   sent from its master device(s).
 </p>
 
+<p>
+  The <dfn>Transport Bar</dfn> at the top of the window is made of :
+</p>
+
+<ul>
+  <li><a href="/controlling-playback/using-the-transport-bar/">the Transport Controls</a></li>
+  <li><a href="/ardours-interface/using-ardour-clock-displays/">the Clocks</a></li>
+  <li>3 status indicators:
+    <ul>
+      <li><dfn>Solo</dfn>: Blinks when 1 or more track(s) are being soloed, see <a href="/mixing/muting-and-soloing/">Muting and Soloing</a>. Clicking this button while active toggles the solo off on all tracks.</li>
+      <li><dfn>Audition</dfn>: Blinks when using the import dialog to audition material.</li>
+      <li><dfn>Feedback</dfn>: Blinks when Ardour detects a <dfn>feedback loop</dfn>, which happens when the output of an audio signal chain is plugged back to its input. This is probably not wanted and can be dangerous for the hardware and the listener.</li>
+    </ul></li>
+  <li>A global Meter, showing the level of the Master Output, see <a href="/ardours-interface/meters/">Metering in Ardour</a></li>
+  <li>the Mode Selector, allowing to switch between Editor and Mixer views, or edit the Preferences.</li>
+</ul>
+
 {% children %}
diff --git a/_manual/05_controlling-playback/01_using-the-transport-bar.html b/_manual/05_controlling-playback/01_using-the-transport-bar.html
new file mode 100644 (file)
index 0000000..e10d9bf
--- /dev/null
@@ -0,0 +1,48 @@
+---
+layout: default
+title: Using the Transport Bar
+---                        
+
+<p>
+  The <dfn>Transport Bar</dfn> groups all the actions regarding the control of
+playback and recording.
+</p>
+<img src="/images/transport.png" 
+alt="The transport controls" />
+
+<p>This bar is made of (from left to right):</p>
+
+<ul>
+  <li><dfn>Midi Panic</dfn>: allows to immediately stop all midi output.</li>
+  <li><dfn>Enable/disable Audio Click</dfn>: Toggles (on/off) a click track (metronome) along the <a href="/tempo-meter/tempo-and-meter/">tempo</a>.</li>
+  <li><dfn>Go to Start of the Session</dfn>: Jumps back at the beginning of the session, as defined by the <a href="/working-with-markers/">start marker</a>.</li>
+  <li><dfn>Go to End of the Session</dfn>: Jumps forward to the end of the session, as defined by the <a href="/working-with-markers/">end marker</a>.</li>
+  <li><dfn>Play Loop Range</dfn>: Repeats the defined <a href="/controlling-playback/looping-the-transport/">loop</a> as defined by the <a href="/working-with-markers/loop-range/">Loop range</a>, until the "Stop playback" button is pressed. Clicking the "Play loop Range" button while already active switches to normal Play mode, which allows to exit the loop without stopping and restarting the playback.</li>
+  <li><dfn>Play Range/Selection</dfn>: If a range has been defined using the Range Mode button, plays the range, of if an audio or MIDI region is selected,plays this region. In both cases, the playback stops at the end of the range or selected region.</li>
+  <li><dfn>Play from playhead</dfn>: Starts the playback and optionnally record (more bellow).</li>
+  <li><dfn>Stop</dfn>: Whatever the playing mode (loop, range, ...) stops all playback. Some effects (like chorus) might still be audible for a while.</li>
+  <li><dfn>Toggle Record</dfn>: Global switch button to activate/desactivate recording. While active, the button blinks red. The button doesn"t start the recording itself : if one or more tracks are marked as record-enabled, pressing the "Play from Playhead" starts the recording on this/these track(s). See <a href="/recording/">Recording</a>.</li>
+</ul>
+
+<p class="note">All this actions are binded to keyboard shortcuts, which allow for a speedier use, and a more focused work</p>  
+
+<p>Under these buttons is the <dfn>Shuttle Speed Control</dfn> that allows to scrub through the audio quickly.</p>
+
+<p>The Shuttle Speed Control supports 2 operating modes, that can be chosen with right click > Mode :</p>
+<ul>
+  <li><dfn>Sprung mode</dfn> that allows for a temporary scrub : it only scubs while the mouse is left clicked on the control.</li>
+  <li><dfn>Wheel mode</dfn> that allows to set a playback speed until the "Stop" button is pressed, which stops the playback and resets its speed.
+</ul>
+<p>The mode is displayed on the right of the control. The current playback speed is shown by a green slider, that is square and centered when the playback speed is normal (1X) and becomes a circle when its changed. The further from the center the slider is set, the faster the playback will scrub in both directions, as displayed on the left of the control.<p>
+
+<p>The 3 vertical buttons on the right of the transport bar control the behviour of the playhead :</p>
+<ul>
+  <li><dfn>Internal/MTC</dfn> defines if the current timecode is handled by Ardour, or by an external Midi device (see <a href="/synchronization/timecode-generators-and-slaves/">Timecode Generators and Slaves</a>).</li>
+  <li><dfn>Follow Edits</dfn> is a toggle switch that defines if the playhead is moved when using the Grab Mode or the Range Mode tools, i.e. if any action on the canvas moves the playhead along.</li>
+  <li><dfn>Auto Return</dfn> is a toggle switch too. When active, pressing the Stop button returns the playhead to its previous position, and when inactive, pressing Stop keeps the playhead at its current location. Activating Auto Return can be usefull for earing back the same part of the audio before and after having tweaked it, without having to loop on it.</li>
+</ul>
+
+
+
+
+  
diff --git a/_manual/05_controlling-playback/05_using-the-transport-bar.html b/_manual/05_controlling-playback/05_using-the-transport-bar.html
deleted file mode 100644 (file)
index 32ccec2..0000000
+++ /dev/null
@@ -1,9 +0,0 @@
----
-layout: default
-title: Using the Transport Bar
----                        
-
-
-  
-  
-  
index 4060e569d56224cd08dd544fc510ccb2b412af5f..f25b646740485785cfbf813d00fb68dbc817c172 100644 (file)
@@ -11,7 +11,7 @@ menu_title: Tempo and Meter
 </p>
 <p class="note">When performing meter or tempo operations, it is advised that you show the BBT ruler (available by right-clicking an existing marker or ruler name),
   and ensure that the constraint modifier is set (in Preferences->User Interaction) so that no other modifiers share its key combination.<br>
-  The constraint modifier is the "Constrain drags using : " setting under the "When Beginning a Drag" heading. One viable setting is control-shift.
+  The constraint modifier is the "Constrain drags using : " setting under the "When Beginning a Drag" heading. One viable setting is <kbd class="mod1"></kbd><kbd class="mod3"></kbd>.
 </p>
 
 <h3>Tempo</h3>
@@ -97,7 +97,7 @@ If you need another bar, lock the meter to music again (right click->"Lock to Mu
 <br>
 <li>To change a meter, double click it. A dialog will appear.</li>
 <br>
-<li>To copy a meter, hold down control and drag it.</li>
+<li>To copy a meter, hold down <kbd class="mod1"></kbd> and drag it.</li>
 
 <h3>Techniques </h3>
 <p>As a general approach, the best way to control tempo ramps is to use them in pairs.
@@ -115,9 +115,9 @@ You will see this reflected in the tempo lines.. they won't quite match the drum
 We now locate the earliest position where the click doesn't match, and place a new tempo just before this.
 Two bars later, place another new tempo.
 </p>
-Now while dragging any beat <strong>after</strong> the second new tempo, watch the drum audio and tempo lines until they align.
-<p class="note">
-Notice what is happeneing here: the tempo previous to your mouse pointer is being changed so that the beat you grabbed
+<p>Now while dragging any beat <strong>after</strong> the second new tempo, watch the drum audio and tempo lines until they align.
+</p>
+<p class="note">Notice what is happeneing here: the tempo previous to your mouse pointer is being changed so that the beat you grabbed
 aligns with the pointer.
 Notice that the tempo lines previous to the changed one also move. This is because the previous tempo is ramping <strong>to</strong> the tempo you are changing.
 Look further to the left. The tempo lines in the first four bars do not move.
index 114abf35daafe42d1f6b63d32eddf7c64cbfa21f..ea1967ac7744121c5e6804fe26fa7093007c7ffe 100644 (file)
@@ -322,7 +322,20 @@ kbd.mouse {
 }
 */
 
-kbd.menu,kbd.option,kbd.optoff {
+kbd.optoff, kbd.option {
+    border:none;
+    background-color:transparent;  
+}
+
+kbd.optoff:after {
+    content:url('/images/checkbox-unchecked.png');  
+}
+
+kbd.option:after {
+    content:url('/images/checkbox-checked.png');
+}
+
+kbd.menu {
     border:none;
     background-color:transparent;
     font-weight:bold;
@@ -330,22 +343,10 @@ kbd.menu,kbd.option,kbd.optoff {
     white-space:normal;
 }
 
-kbd.option:after,kbd.optoff:after {
-    font-family:mono;
-    font-weight:lighter;
-    text-align:center;
-    border:solid 1px black;
-    margin-left:0.3em;
-}
-kbd.option:after {
-    content:'X';
 
-}
 kbd.osc {
 }
-kbd.optoff:after {
-    content:'    ';
-}
+
 
 
 kbd.fader, kbd.knob, kbd.button {
diff --git a/source/images/checkbox-checked.png b/source/images/checkbox-checked.png
new file mode 100644 (file)
index 0000000..d0b7690
Binary files /dev/null and b/source/images/checkbox-checked.png differ
diff --git a/source/images/checkbox-unchecked.png b/source/images/checkbox-unchecked.png
new file mode 100644 (file)
index 0000000..d28b057
Binary files /dev/null and b/source/images/checkbox-unchecked.png differ
diff --git a/source/images/transport-bar.png b/source/images/transport-bar.png
new file mode 100644 (file)
index 0000000..a15cd5f
Binary files /dev/null and b/source/images/transport-bar.png differ
diff --git a/source/images/transport.png b/source/images/transport.png
new file mode 100644 (file)
index 0000000..6b9a423
Binary files /dev/null and b/source/images/transport.png differ