]> Shamusworld >> Repos - ardour-manual/blobdiff - include/other-toolbar-items.html
6.7: Added 'Rec' to mode selector and shortcuts to script buttons
[ardour-manual] / include / other-toolbar-items.html
index c4f8c754486f95f9786297f85a1df5dae0e7ff60..36d41fc7fb3689968b1cf054e0300c8128e0e36a 100644 (file)
@@ -1,6 +1,11 @@
 <h2 id="monitor-options">The Monitor Options</h2>
 
-<img src="/images/input-mode-buttons.png" alt="The Monitor options">
+<figure>
+       <img alt="The Monitor options" src="/images/input-mode-buttons.png">
+       <figcaption>
+               The Monitor options
+       </figcaption>
+</figure>
 
 <p>
   These buttons allow switching the monitoring mode globally, for all the tracks at once.
 </p>
 <ul>
        <li>When not playing: all tracks are on In (to listen to any connected source)</li>
-  <li>When playing, all tracks are on Disk (to play whatever was recoded on those tracks)</li>
+  <li>When playing, all tracks are on Disk (to play whatever was recorded on those tracks)</li>
        <li>When recording, on rec-enabled tracks: In and on non rec-enabled ones: Disk</li>
 </ul>
 
+<h2 id="latency-compensation-info">The Latency Compensation Info</h2>
+
+<figure>
+       <img alt="The Latency Compensation Info" src="/images/latency-compensation-info.png">
+       <figcaption>
+               Latency Compensation Info
+       </figcaption>
+</figure>
+
+<p>
+  This section show information about the latency compensation Ardour sets
+  to align all signals in time whatever their route (and processing applied).
+</p>
+
+<p>
+  The only button <kbd class="menu">Disable PDC</kbd> allows to enable/disable
+  the <em>P</em>lugin <em>D</em>elay <em>C</em>ompensation. Enabling it will
+  make all signal perfectly aligned, while disabling it will reduce the delay,
+  at the expense of slightly misaligned signals for tracks that have plugins introducing
+  latency.
+</p>
+
+<p>
+       The two infos are:
+</p>
+<ul>
+       <li>the worst route latency</li>
+       <li>the I/O latency, i.e. the worst latency pre-roll</li>
+</ul>
 
 
 <h2 id="playhead_options">The Playhead Options</h2>
 
-<img src="/images/playhead-options.png" alt="The playhead options">
+<figure>
+       <img alt="The playhead options" src="/images/playhead-options.png">
+       <figcaption>
+               The playhead options
+       </figcaption>
+</figure>
 
 <p>
   Those 2 buttons control the behaviour of the playhead:
 
 <h2 id="status_indicators">The Status indicators</h2>
 
-<img src="/images/status_buttons.png" alt="The Status buttons">
+<figure>
+       <img alt="The Status buttons" src="/images/status_buttons.png">
+       <figcaption>
+               The Status buttons
+       </figcaption>
+</figure>
 
 <p>
   The <dfn>Status</dfn> buttons show the current session state:
 </p>
 
 <table class="dl">
-  <tr><th>Solo</th><td>Blinks when one or more tracks are being soloed, see <a href="@@muting-and-soloing">Muting and Soloing</a>. Clicking this button disables any active explicit and implicit solo on all tracks and busses. Clicking this button desactivates the solo on every track/bus.</td></tr>
-  <tr><th>Audition</th><td>Blinks when some audio is auditionned, e.g. by using the import dialog, or using the <kbd class="menu">Audition</kbd> context menu in the <a href="@@the-region-list">Regions List</a>. Clicking this button stops the auditionning.</td></tr>
+  <tr><th>Solo</th><td>Blinks when one or more tracks are being soloed, see <a href="@@muting-and-soloing">Muting and Soloing</a>. Clicking this button disables any active explicit and implicit solo on all tracks and busses. Clicking this button deactivates the solo on every track/bus.</td></tr>
+  <tr><th>Audition</th><td>Blinks when some audio is auditioned, e.g. by using the import dialog, or using the <kbd class="menu">Audition</kbd> context menu in the <a href="@@the-region-list">Regions List</a>. Clicking this button stops the auditioning.</td></tr>
   <tr><th>Feedback</th><td>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.</td></tr>
 </table>
 
-<h2 id="mode_selector">The Mode Selector</h2>
+<h2 id="monitor_section_info">The Monitor Section Info</h2>
+
+<figure>
+       <img alt="Monitor Section Info" src="/images/monitor-section-info.png">
+       <figcaption>
+               Monitor Section Info
+       </figcaption>
+</figure>
 
-<img src="/images/mode-selector_scripts_meter.png" alt="The Status buttons">
+<p>
+  This section is only useful and active if the session has a
+  <a href="@@monitor-section">Monitor section</a>. The three buttons are
+  exactly linked to their counterparts in the Monitor slice of the mixer,
+  but as they sit in the toolbar, remain visible even in Editor mode.
+</p>
 
 <p>
-  The Mode Selector allows switching between the Editor and Mixer windows.
-  If a window is detached, the corresponding button is lit in blue. Clicking the botton
-  switches the detached window visibility.
+       The three buttons are:
 </p>
+<ul>
+  <li><dfn>Mono</dfn>: sums all of the paths to a single mono signal and applies it to all Monitor Section outputs.</li>
+  <li><dfn>Dim All</dfn>: Reduces overall monitor level by the amount set with the Dim level control.</li>
+  <li><dfn>Mute All</dfn>: Mutes all monitoring.</li>
+</ul>
+
+
+<h2 id="mode_selector">The Master Level Meter</h2>
 
+<figure>
+       <img alt="The Master Level Meter" src="/images/master-level-meter.png">
+       <figcaption>
+               The Master Level Meter
+       </figcaption>
+</figure>
 <p>
-  The global meter shows the levels of the master's output. Its the same meter that sits
-  in the <a href="@@master-bus-strip">Master's Mixer strip</a>,
-  and also shows a peak indicator, that turns red when  any level exceeds 0dB. It can
-  be reset by a <kbd class="mouse">Left</kbd> click.
+  The global meter shows the levels of the master's output. Its the same
+  meter that sits in the <a href="@@master-bus-strip">Master's Mixer strip</a>,
+  and also shows a peak indicator, that turns red when  any level exceeds
+  0dB. It can be reset by a <kbd class="mouse">Left</kbd> click.
 </p>
 
+<h2 id="mode_selector">Script/Shortcut buttons</h2>
+
+<figure>
+       <img alt="The Script buttons" src="/images/script-buttons.png">
+       <figcaption>
+               The Script/shortcuts buttons
+       </figcaption>
+</figure>
+
+<p>
+  The buttons in between the Mode Selector and the Master Level Meter are
+  script or shortcuts buttons, which are user-definable buttons to attach
+  any session <a href="@@lua-scripting">lua-script</a> to, or any action
+  shortcut (e.g. for tasks that are used often and buried deep inside
+  nested menus).
+</p>
 <p>
-  The buttons in between the Mode Selector and the global meter are script buttons,
-  which are user-definable buttons to attach any session <a href="@@lua-scripting">lua-script</a> to.
+  The number of buttons (precisely, the number of columns of two buttons)
+  can be set in the <a href="@@preferences#preferences-appearance-toolbar">Preferences</a>.
 </p>
+<p>
+  <kbd class="mouse">Left</kbd>-clicking an affected button launches the
+  script or shortcut, while <kbd class="mouse">right</kbd>-clicking or 
+  clicking an unaffected button allows change the script/shortcut 
+  the button should execute.
+</p>
+
+
+<h2 id="mode_selector">The Mode Selector</h2>
+
+<figure>
+       <img alt="The Mode Selector" src="/images/mode_selector.png">
+       <figcaption>
+               The Mode Selector
+       </figcaption>
+</figure>
 
+<p>
+  The Mode Selector allows switching between the Editor, Mixer or Recording
+  windows. If a window is detached, the corresponding button is lit.
+  Clicking the button switches the detached window visibility.
+</p>