From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Thu, 3 Nov 2022 16:12:54 +0000 (+0300)
Subject: Add basic documentation on the Quick Audio Export dialog
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=8f53ffa4909b30ba6c6a9c156a8ea64f13afb68a

Add basic documentation on the Quick Audio Export dialog
---

diff --git a/include/quick-audio-export.html b/include/quick-audio-export.html
new file mode 100644
index 0000000..423391f
--- /dev/null
+++ b/include/quick-audio-export.html
@@ -0,0 +1,41 @@
+<p>
+  The <kbd class="window">Quick Audio Export</kbd> dialog is a trimmed-down
+  version of its original counterpart. It's best for cases when all the user
+  needs is exporting an entire session (or part of it) to something like a WAV
+  file at the session rate.
+</p>
+
+
+<figure>
+  <img style="width:50%;" width="50%" src="/images/quick-audio-export-dialog.png"
+  alt="Quick Audio Export Dialog">
+  <figcaption>Quick Audio Export Dialog</figcaption>
+</figure>
+
+<p>
+  The three available options are:
+</p>
+
+<table class="dl">
+  <tr>
+  	<th>Format preset</th>
+  	<td>Lists popular options such as FLAC, WAV @ session rate, MP3, and others.
+  	</td>
+  </tr>
+  <tr>
+  	<th>Export range</th>
+  	<td>Allows choosing between exporting a selection (range) or the entire
+  	session (from session start marker to session end marker). Only lists the
+  	latter option if no selection is available.
+  </td></tr>
+  <tr>
+  	<th>After export</th>
+  	<td>Allows choosing whether to open the folder where the audio file has been
+  	exported to, or do nothing.
+  </td></tr>
+</table>
+
+<p>
+  Ongoing export can be canceled by pressing the
+  <kbd class="button">Abort</kbd> button.
+</p>
\ No newline at end of file
diff --git a/include/the-session-menu.html b/include/the-session-menu.html
index a2437b1..923e648 100644
--- a/include/the-session-menu.html
+++ b/include/the-session-menu.html
@@ -25,6 +25,7 @@
 	<tr><th>Remove Video</th><td>Removes the video part of the session (the video timeline disappears)</td></tr>
 	<tr><th>Loudness Assistant&hellip;</th><td>Shows the Loudness Analyzer and Normalizer, allowing an in-depth analysis of the master bus' volume for the final export</td></tr>
 	<tr><th colspan="2">Export</th></tr>
+		<tr><th class="sub1">Quick Audio Export&hellip;</th><td><a href="@@quick-audio-export">Export</a> a selection or the entire session to audio with just a few settings</td></tr>
 		<tr><th class="sub1">Export to Audio File(s)&hellip;</th><td><a href="@@mixdown">Export</a> all or part of the session in audio form</td></tr>
 		<tr><th class="sub1">Stem export&hellip;</th><td><a href="@@export-dialog">Exports each track</a> as its own audio file (for e.g. DAW interchange)</td></tr>
 		<tr><th class="sub1">Export to Video File</th><td>Exports the session to a <a href="@@workflow-amp-operations">video file</a></td></tr>
diff --git a/master-doc.txt b/master-doc.txt
index 82f71d1..4c439a3 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1083,6 +1083,14 @@ uri: exporting/export-dialog
 part: subchapter
 ---
 
+---
+title: Quick Audio Export
+include: quick-audio-export.html
+link: quick-audio-export
+uri: exporting/quick-audio-export
+part: subchapter
+---
+
 ---
 title: Export Format Profiles
 include: export-format-profiles.html
diff --git a/source/images/quick-audio-export-dialog.png b/source/images/quick-audio-export-dialog.png
new file mode 100644
index 0000000..71cb1bd
Binary files /dev/null and b/source/images/quick-audio-export-dialog.png differ