a button to list all the files that would be erased and replaced.
</p>
-<h2>Analyze exported audio</h2>
+<h2 id="export_analyze">Analyze exported audio</h2>
<figure>
<img width="50%" src="/images/export-report-analysis.png" alt="The Export Report/Analysis window">
<p>
- The <dfn>Main Menu</dfn> is made of 8 menus that allow the user to interact with Ardour, and below is a reference of all the menu actions.
+ The <dfn>Main Menu</dfn> allows the user to interact with Ardour and may
+ appear daunting at first. Below is a reference of all the menus and submenus.
+</p>
+
+<p class="note">
+ Most of these menus, and probably all of the most used
+ ones, have keyboard shortcuts to make using them easier and faster. A
+ summary of these shortcuts can be found on the <a
+ href="@@default-keyboard-bindings">Defaults Keyboard Bindings</a>
+ page, and every menu in Ardour can be reassigned to an user defined
+ key binding, or used via <a
+ href="@@controlling-ardour-with-osc">OSC</a> with a control surface.
</p>
<p>
- Notice that a lot of these menus, and probably all of the most used ones, have keyboard shortcuts to make using them easier and faster.
- A summary of these shortcuts can be found on the <a href="@@default-keyboard-bindings">Defaults Keyboard Bindings</a> page, and
- every menu in Ardour can be reassigned to an user defined key binding, or used via <a href="@@controlling-ardour-with-osc">OSC</a> with
- a control surface.
+ Some menu items placement may depend on the OS, e.g. the "About"
+ window may not be in the <kbd class="menu">Help</kbd> menu on Mac
+ systems.
</p>
<tr><th class="sub1">Separate Under</th><td>Removes all the parts of the regions that are under the selected one. Once done, the selected region is alone on its part of the track.</td></tr>
<tr><th class="sub1">Separate Using Loop Range</th><td>Cuts the selected regions or the regions on the selected tracks along the Loop range's start and end markers. If nothing is selected, acts on all tracks at once.</td></tr>
<tr><th class="sub1">Separate Using Punch Range</th><td>Same as above, with the Punch range markers</td></tr>
+ <tr><th colspan="2">Consolidate</th></tr>
+ <tr><th class="sub1">Consolidate Range</th><td>Group all parts of regions in the range and on the same track as one (Audio or MIDI but not both). Optionnaly, add it to the Cue Grid and/or to the Clip library.</td></tr>
+ <tr><th class="sub1">Consolidate Range (with processing)</th><td>Same as above, with processing (effects, plugins, gain&hellip) applied before grouping.</td></tr>
+ <tr><th class="sub1">Combine</th><td>Group all the selected regions belonging to the same track as one (Audio or MIDI but not both).</td></tr>
+ <tr><th class="sub1">Uncombine</th><td>(Audio only) splits back a compound into its original regions.</td></tr>
<tr><th colspan="2">Align</th></tr>
<tr><th class="sub1">Align Start</th><td>Moves the selected regions to align the beginning of the regions to the Edit point</td></tr>
<tr><th class="sub1">Align Start Relative</th><td>When multiple regions are selected, moves all the regions together as a block to align the beginning of the earliest one to the Edit point.</td></tr>
<tr><th class="sub1">Set Fade Out Length</th><td>Same as above, for the fade out</td></tr>
<tr><th class="sub1">□ Fade Out</th><td>Toggles the fade out on the selected region on or off</td></tr>
+ <tr><th colspan="2">Analyze</th></tr>
+ <tr><th class="sub1">Spectral Analysis</th><td>For the selected range and tracks, shows the Spectral analysis, showing a frequency vs dBFS graph.</td></tr>
+ <tr><th class="sub1">Loudness Analysis</th><td>For the selected range, one tab per track, shows the <a href="@@export-dialog#export_analyze">Audio Report/Analysis</a>, showing in particular a time vs dBFS graph.</td></tr>
+ <tr><th class="sub1">Loudness Assistant</th><td>For the selected range and tracks, shows the <a href="@@loudness-analyzer">Loudness Analyzer and Normalizer</a>.</td></tr>
+
<tr><th>Tag Last Capture</th><td>Prompts for a text to tag the last record, this tag is visible in the <a href="@@the-region-list">Region list</a></td></tr>
<tr><th>Remove Last Capture</th><td>Destroy the last recording. A prompt reminds the user this <em>cannot</em> be undone.</td></tr>
<tr><th class="sub1">Next Quantize Grid Choice</th><td>Changes the snap quantization to the next one in the list below</td></tr>
<tr><th class="sub1">○ No Grid</th><td>Disables <a href="@@grid-controls">snapping</a>, i.e. allows free movement of regions and boundaries</td></tr>
- <tr><th class="sub1">○ Bar</th><td>Snaps to the
next musical bar, bars can be set and seen in the <a href="@@ruler">Ruler</a></td></tr>
+ <tr><th class="sub1">○ Bar</th><td>Snaps to the
closest musical bar, bars can be set and seen in the <a href="@@ruler">Ruler</a></td></tr>
<tr><th class="sub1">○ 1/4 Note → 1/28 (32nd septuplet)</th><td>Selects the division of musical time to snap to</td></tr>
+ <tr><th class="sub1">○ Timecode</th><td>Snaps to the closest frame, a timecode being Hrs:Min:Sec:Frame. The number of frames per second is defined in the <a href="@@session-properties#properties-timecode">Session Properties</a>.</td></tr>
+ <tr><th class="sub1">○ MinSec</th><td>Snaps to the closest second in the timeline.</td></tr>
+ <tr><th class="sub1">○ CD Frames</th><td>Snaps to the closest CD Frame, one CD frame being 1/75<sup>th</sup> of a second.</td></tr>
+
<tr><th colspan="2">Tempo</th></tr>
<tr><th class="sub1">Set Tempo from Region = Bar</th><td>Computes the tempo so that the duration of the first selected region is 1 bar. Ardour prompts if the user wants it to be the global tempo, or a tempo marker at the beginning of the region used</td></tr>
<tr><th class="sub1">Set Tempo from Edit Range = Bar</th><td>Same thing, with the current Range instead of a region</td></tr>
</p>
<table class="dl">
- <tr><th>□ About</th><td>Shows the <kbd class="menu">About Ardour</kbd> window, which contains information about the version, config, authors,and license of Ardour</td></tr>
+ <tr><th>□ About</th><td>Shows the <kbd class="menu">About Ardour</kbd> window, which contains information about the version, config, authors, and license of Ardour</td></tr>
<tr><th>Chat</th><td>This is a shortcut to the webchat version of the Freenode IRC channel of Ardour, where the developers meet, and questions can be asked if the Manual is not enough</td></tr>
<tr><th>Tutorial</th><td>Link to a FLOSSManual guide to Ardour</td></tr>
<tr><th>Reference</th><td>Link to this manual, hosted on ardour.org</td></tr>
<tr><th class="sub1">Legatize</th><td>Shortens or elongates the MIDI notes to make them perfectly sequential, i.e. the end of a note is the start of the following one</td></tr>
<tr><th class="sub1">Remove Overlap</th><td>Shortens or elongates the MIDI notes to make them perfectly sequential, i.e. the end of a note is the start of the following one</td></tr>
<tr><th class="sub1">Transform…</th><td><a href="@@transforming-midi---mathematical-operations"><kbd class="menu">Transform</kbd> window</a>, that allows for mathematical operations on the midi notes</td></tr>
- <tr><th class="sub1">Unlink from Other copies</th><td>Makes the selected MIDI region independent, e.g. editing this region won't affect any other one.</td></tr>
+ <tr><th class="sub1">Unlink all selected regions</th><td>Makes the selected MIDI regions independent, e.g. editing this region won't affect any other one.</td></tr>
+ <tr><th class="sub1">Unlink from unselected</th><td>Makes the selected MIDI regions independent from regions outside the selection, but keep the link between the selected ones.</td></tr>
+ <tr><th class="sub1">Deinterlace Into Layers</th><td>Splits the selected region(s) to create in-place copies each containing only one channel. A region containing e.g. 3 channels will generate 3 stacked regions containing 1 channel each.</td></tr>
<tr><th class="sub1">List Editor…</th><td>Shows the <a href="@@midi-list-editor"><kbd class="menu">List Editor</kbd></a> which sequentially lists all the MIDI events in the region, and allows for precise modifications</td></tr>
<tr><th colspan="2">Gain</th></tr>
<tr><th class="sub1">□ Opaque</th><td>When checked, makes the region opaque audio-wise, i.e., the underlying regions won't be audible</td></tr>
<tr><th class="sub1">Large</th><td>Same as above, but again less high</td></tr>
<tr><th class="sub1">Normal</th><td>Sets the height of the track to its default value which is a trade-off between readability and number of tracks displayed</td></tr>
<tr><th class="sub1">Small</th><td>Reduces the size of the tracks to a low value, increasing the number of on screen tracks</td></tr>
-
- <tr><th>Toggle Layer Display</th><td>Toggles the selected track(s) visual <a href="@@layering-display">layering display</a> between <em>overlaid</em> and <em>stacked</em></td></tr>
-
+
<tr><th>Toggle Active</th><td>Toggles the active state of a track. An inactive track will be grayed and won't play any sound. That can be seen in the <kbd class="menu">A</kbd> column of the <a href="@@the-tracks-and-busses-list">Tracks and Busses List</a></td></tr>
<tr><th>Remove</th><td>Deletes this track and its playlist (no file is harmed in the process, and the regions from the playlist stay in the Editor for later use)</td></tr>
</table>
<tr><th colspan="2">Play</th></tr>
<tr><th class="sub1">Play Selection</th><td>Only plays the selected duration of the session, based on the current range or selected region(s)</td></tr>
<tr><th class="sub1">Solo Selection</th><td>Only plays the selected regions of the session. Regions that are not selected, even on a track with selected regions, wont be played</td></tr>
- <tr><th class="sub1">Play
Selection w/Preroll</th><td>As the previous menu, except it starts the playback a few bars or seconds before the beginning of the selection (the amount of time can be set in the <a href="@@preferences#preferences-transport">Preferences</a>)</td></tr>
+ <tr><th class="sub1">Play w/Preroll</th><td>As the previous menu, except it starts the playback a few bars or seconds before the beginning of the selection (the amount of time can be set in the <a href="@@preferences#preferences-transport">Preferences</a>)</td></tr>
<tr><th class="sub1">Start/Continue/Stop</th><td>Leaves loop play or range play mode but without stopping the transport</td></tr>
<tr><th class="sub1">Play from Edit Point and Return</th><td>Starts the playback at the <a href="@@edit-point-control">Edit point</a>, and when stopped, goes back to the original location</td></tr>
<tr><th class="sub1">Play Loop Range</th><td>If a <a href="@@the-loop-range">Loop range</a> is defined, play it and loop until stopped</td></tr>
<tr><th class="sub1">Jump to Next Mark</th><td>moves the playhead to the next <a href="@@creating-location-markers">marker</a> on the Ruler</td></tr>
<tr><th class="sub1">Jump to Previous Mark</th><td>Same, to the left</td></tr>
+ <tr><th class="sub1">Jump to Loop Start</th><td>moves the playhead to the <a href="@@the-loop-range">loop</a> start marker if a loop exists</td></tr>
+ <tr><th class="sub1">Jump to Loope End</th><td>Same, for the loop end marker</td></tr>
+
<tr><th class="sub1">Go to Zero</th><td>Sends the playhead to the 00:00:00:00 time, regardless of the sessions Start marker</td></tr>
<tr><th class="sub1">Go to Start</th><td>Sends the playhead to the Start marker of the session</td></tr>
<tr><th class="sub1">Go to End</th><td>Sends the playhead to the End marker of the session</td></tr>
<tr><th class="sub1">Set Session Start from Playhead</th><td>Puts the Start of the session marker at the playhead's position</td></tr>
<tr><th class="sub1">Set Session End from Playhead</th><td>Puts the End of the session marker at the playhead's position</td></tr>
-
+ <tr><th colspan="2">Cues</th></tr>
+ <tr><th class="sub1">Trigger Cue <em>A → H</em></th><td>Starts the playback and triggers the <em>A → H</em> line of the <a href="@@cue-window-elements#cue_window_grid">Cue grid</a></td></tr>
+
<tr><th>□ Time Master</th><td>Sets Ardour as the Time master, i.e. Ardour sends the time information to the audio system</td></tr>
<tr><th>□ Punch In/Out</th><td>Based on the Punch in and Punch out markers if they exist, tells Ardour to record only between those two points</td></tr>
<tr><th>□ Punch In</th><td>Based on the Punch in marker, only allow to record from this point on</td></tr>
<table class="dl">
<tr><th>□ Maximise Editor Space</th><td>Puts the Editor window in full screen mode</td></tr>
<tr><th>□ Maximize Mixer Space</th><td>Puts the Mixer window in full screen mode</td></tr>
+
<tr><th colspan="2">Region Layers</th></tr>
<tr><th class="sub1">Stacked Layer Display</th><td>When multiple takes are available, this will display them on top of one another</td></tr>
<tr><th class="sub1">Overlaid Layer Display</th><td>When multiple takes are available, the most recent one will be displayed on top of older ones</td></tr>
<tr><th colspan="2">Automation</th></tr>
<tr><th class="sub1">Toggle All Existing Automation</th><td>Show or hides all the <a href="@@automation">automation lanes</a> that have been edited by the user</td></tr>
- <tr><th>Toggle Layer Display</th><td>Toggles all the track(s) visual <a href="@@layering-display">layering display</a> between <em>overlaid</em> and <em>stacked</em></td></tr>
<tr><th colspan="2">Primary Clock</th></tr>
<tr><th class="sub1">Focus On Clock</th><td>Sets the focus on the <a href="@@transport-clocks">main clock</a>, allowing to type in numbers directly to change the playhead position</td></tr>
<tr><th class="sub1">Timecode</th><td>Sets the main clock in timecode mode, so it displays time in the Hours:Minutes:Seconds:Frames format</td></tr>
<tr><th class="sub1">□ Bars & Beats</th><td>Same as the above, with the time formatted as Bars:Beats:Ticks</td></tr>
<tr><th class="sub1">□ Time Signature</th><td>Shows / hides the time signature line in the ruler, where the signature can be adjusted along the playline</td></tr>
<tr><th class="sub1">□ Tempo</th><td>Shows / hides the Tempo line, where the BPM can be changed with markers</td></tr>
- <tr><th class="sub1">□ Ranges</th><td>Shows / hides the Range line, where ranges can be defined</td></tr>
- <tr><th class="sub1">□ Loop/Punch</th><td>Shows / hides the Loop/Punch line, where loops and Punches can be defined</td></tr>
+ <tr><th class="sub1">□ Range Markers</th><td>Shows / hides the Range line, where ranges can be defined</td></tr>
+ <tr><th class="sub1">□ Loop/Punch Ranges</th><td>Shows / hides the Loop/Punch line, where loops and Punches can be defined</td></tr>
<tr><th class="sub1">□ CD Markers</th><td>Shows / hides the Range line, where CD Markers can be defined</td></tr>
- <tr><th class="sub1">□ Markers</th><td>Shows / hides the Markers line, where custom markers can be defined</td></tr>
+ <tr><th class="sub1">□ Location Markers</th><td>Shows / hides the Markers line, where custom markers can be defined</td></tr>
<tr><th class="sub1">□ Cue markers</th><td>Shows / hides the Cue line, where Cue markers can be set to trigger entire cues</td></tr>
- <tr><th class="sub1">□ Video</th><td>Shows / hides the Video timeline, where frames of the video are shown for syncing purposes</td></tr>
+ <tr><th class="sub1">□ Video Timeline</th><td>Shows / hides the Video timeline, where frames of the video are shown for syncing purposes</td></tr>
+
<tr><th colspan="2">Zoom</th></tr>
<tr><th class="sub1">Zoom In</th><td>Zooms in, focusing the <em>Zoom Focus</em> (see below)</td></tr>
<tr><th class="sub1">Zoom Out</th><td>Zooms out</td></tr>
<tr><th class="sub1">Scroll Tracks Up</th><td>Same as above, towards the top</td></tr>
<tr><th class="sub1">Scroll Forward</th><td>Scrolls the view toward the right of the session from one screen (horizontally, so along time)</td></tr>
<tr><th class="sub1">Scroll Backward</th><td>Same as above, to the left</td></tr>
+
<tr><th colspan="2">Video Monitor</th></tr>
<tr><th class="sub1">Original Size</th><td>When the <a href="@@video-timeline-and-monitoring">Video Monitor</a> is active, resets its size to the original size, i.e. 1 pixel in the video is 1 pixel on screen</td></tr>
<tr><th class="sub1">□ Letterbox</th><td>When checked, forces the ratio (width/height) to be the one of the original video. If unchecked, the video will be stretched to fit the window</td></tr>
<tr><th class="sub1">□ Timecode</th><td>When checked, displays a Timecode over the video, in the Hours:Minutes:Seconds:Frames format</td></tr>
<tr><th class="sub1">□ Frame number</th><td>When checked, shows the absolute frame number inside the video, i.e. this image is the <em>n</em>th of the video</td></tr>
<tr><th class="sub1">□ Timecode Background</th><td>Adds a black background to the timecode for readability</td></tr>
+
<tr><th colspan="2">Editor Views</th></tr>
<tr><th class="sub1">Save View <em>n</em></th><td>Saves the position on the timeline in the memory, horizontally and vertically (along time and tracks)</td></tr>
<tr><th class="sub1">Go to View <em>n</em></th><td>Loads and displays a saved position (see above)</td></tr>
<tr><th class="sub1">Show Mixer/Hide/Attach/Detach</th><td>Same as for the Editor, for the <em>Mixer</em> window</td></tr>
<tr><th>Recorder</th><td></td></tr>
<tr><th class="sub1">Show Recorder/Hide/Attach/Detach</th><td>Same as for the Editor, for the <em>Recorder</em> window</td></tr>
+ <tr><th>Cue Grid</th><td></td></tr>
+ <tr><th class="sub1">Show Cues/Hide/Attach/Detach</th><td>Same as for the Editor, for the <em>Cue Grid</em> window</td></tr>
<tr><th>Preferences</th><td></td></tr>
<tr><th class="sub1">Show/Hide/Attach/Detach</th><td>Same as for the Editor, for the <em>Preferences</em> window</td></tr>
<tr><th>Meterbridge</th><td>Shows the <a href="@@meterbridge"><kbd class="menu">Meterbridge</kbd> window</a>, that displays all the tracks' meter at once and their recording status, and is very handy for multitrack recording</td></tr>
<tr><th>□ Big Clock</th><td>Opens the <a href="@@transport-clocks">Main Clock</a> as its own separate (and huge) window, which is helpful when recording</td></tr>
<tr><th>□ Transport Controls</th><td>Opens a floating <a href="@@transport-bar">Transport Bar</a> as its own separate window</td></tr>
<tr><th>□ Virtual Keyboard</th><td>Opens up the <a href="@@virtual-keyboard">virtual MIDI keyboard</a>. If a MIDI track is selected (or many), this keyboard can be used as an hardware device would.</td></tr>
+ <tr><th>□ Library Downloader</th><td>Opens up the Library Downloader which allows to download royalty free loopable material from kind people at <a href="https://www.looperman.com/">Looperman</a>.</td></tr>
<tr><th>□ Video Monitor</th><td>If a <a href="@@video-timeline-and-monitoring">video</a> has been imported in the session, opens a video window (namely, <em>Xjadeo</em>), synced to the timeline</td></tr>
<tr><th>□ Bundle Manager</th><td>Opens the <a href="@@bundle-manager">Bundle Manager</a> window, allowing to create and manage <em>Bundles</em>, which are a way to simplify connection management, by defining groups of ports</td></tr>
<tr><th>□ Plugin Manager</th><td>Opens the <a href="@@plugin-manager">Plugin Manager</a>, a dedicated tool to deal with plugins, add new ones, and troubleshoot all plugin-related issues</td></tr>
+ <tr><th>□ I/O Plugins</th><td>Opens the <a href="@@io-plugins">I/O Plugins window</a>, to add I/O plugins, i.e. plugins that are applied before or after all processing, "outside" the session.</td></tr>
<tr><th>Scripting</th><td>Opens the <a href="@@lua-scripting">Script console</a> window where LUA scripts can be edited and run</td></tr>
<tr><th>Templates</th><td>Opens the <a href="@@session-templates">Template Manager</a> window, for both sessions and tracks templates managment</td></tr>
projects / ardour-manual / commitdiff