]> Shamusworld >> Repos - ardour-manual/blob - include/export-dialog.html
More passive form, updated screenshots, updated 'export' and 'vbap panners'
[ardour-manual] / include / export-dialog.html
1
2 <p>
3   When a session is finished mixing, one probably wants to export it to a sound
4   file to burn to a CD, upload to the web, or whatever. <kbd class="menu">Session &gt; Export &gt; Export to Audio file(s)&hellip;</kbd>
5   shows the Export Dialog to do this.
6 </p>
7
8 <figure class="center">
9   <img src="/images/export-dialog-file-format.png" alt="The Export window">
10   <figcaption>
11     The Export window
12   </figcaption>
13 </figure>
14
15 <p>
16   The outputs of multiple tracks and busses all at once can also be exported via
17   <kbd class="menu">Session &gt; Export &gt; Stem Export&hellip;</kbd>.
18 </p>
19
20 <h2>File Format</h2>
21
22 <p>
23   This tab contains controls for the format of the exported audio file(s).
24   More than one format can be enabled here, in which case each will be exported in turn.
25   Ardour is supplied with a list of export formats, including:
26 </p>
27
28 <ul>
29 <li>BWAV 32float</li>
30 <li>CD (Red Book)</li>
31 <li>DVD-A</li>
32 <li>FLAC 24 bit </li>
33 <li>FLAC 24 bit (tagged)</li>
34 <li>Ogg/Vorbis</li>
35 <li>Ogg/Vorbis (tagged)</li>
36 <li>Ring Tone</li>
37 </ul>
38
39 <p>
40   These formats can be edited, or new ones created, with the <a
41   href="@@export-format-profiles">"Edit Export Format Profile"</a> dialog, which
42   appears when clicking the <kbd class="menu">Edit</kbd> or
43   <kbd class="menu">New</kbd> buttons to the right of the drop-down list of
44   formats.
45 </p>
46
47 <p>
48   Presets can also be created, consisting of one or more formats. Ardour
49   provides some ready-made presets, too:
50 </p>
51
52 <ul>
53 <li>CD + DVD-A</li>
54 <li>CD + FLAC</li>
55 <li>CD + FLAC (tagged)</li>
56 <li>CD + Ogg/Vorbis + FLAC (tagged)</li>
57 <li>CD + Ogg/Vorbis</li>
58 <li>CD + Ogg/Vorbis (tagged)</li>
59 <li>CD only</li>
60 <li>DVD-A only</li>
61 <li>FLAC</li>
62 <li>FLAC (tagged)</li>
63 <li>Ogg/Vorbis + FLAC</li>
64 <li>Ogg/Vorbis + FLAC (tagged)</li>
65 <li>Ogg/Vorbis </li>
66 <li>Ogg/Vorbis (tagged)</li>
67 </ul>
68
69 <h2>The location</h2>
70
71 <p>
72   Aside from providing a way to tell Ardour <em>where</em> to put the created file(s),
73   the <dfn>location</dfn> part of the window allows to name the exported files with
74   a lot of choice regarding the naming convention, hence blending into the user's
75   workflow, and providing a clean way to keep the export folders from being cluttered
76   with poorly named files.
77 </p>
78 <p>
79   The name of the file(s) can optionally be made of:
80 </p>
81
82 <ul>
83   <li>The session or snapshot's name</li>
84   <li>A custom label (i.e., any text)</li>
85   <li>A revision number</li>
86   <li>The name of the timespan (see below)</li>
87   <li>A date (in multiple formats)</li>
88   <li>A time (also in multiple format).</li>
89 </ul>
90
91 <p class="note">
92   As in the screenshot above, when writing a file could erase a present file with
93   the same name, Ardour shows a yellow warning line in the bottom of the window, and
94   a button to list all the files that would be erased and replaced.
95 </p>
96
97 <h2>Analyze exported audio</h2>
98
99 <figure>
100   <img src="/images/export-report-analysis.png" alt="The Export Report/Analysis window">
101   <figcaption>
102     The Export Report/Analysis window
103   </figcaption>
104 </figure>
105
106 <p>
107   Checking <kbd class="option">Analyze Exported Audio</kbd> shows the Export Report/Analysis
108   window. This provides a lot of useful information about the exported file:
109 </p>
110 <ul>
111   <li>the file name and location</li>
112   <li>its format</li>
113   <li>its channel count</li>
114   <li>its sample rate</li>
115   <li>its duration and timecode.</li>
116 </ul>
117 <p>
118   It also allows to <kbd class="menu">Play</kbd> the file, and the <kbd class="menu">
119   Open Folder</kbd> button gives a quick access to the place where it has been created.
120 </p>
121 <p>
122   The most prominent feature though, are the two generated views of the audio file
123   in time (waveform) and frequency (sonograph) domain, and the loudness
124   analysis, giving:
125 </p>
126 <ul>
127   <li>the Peak value</li>
128   <li>the True Peak value (to take inter sample peaks into account)</li>
129   <li>the Normalization Gain (if it has been applied)</li>
130   <li>the Integrated Loudness</li>
131   <li>the loudness range</li>
132   <li>a graph of the multiplicity of the peaks at the different loudness levels.</li>
133 </ul>
134
135 <h2>Time Span</h2>
136
137 <figure>
138   <img src="/images/export-dialog-timespan.png" alt="The Time Span tab">
139   <figcaption>
140     The Time Span tab
141   </figcaption>
142 </figure>
143
144 <p>
145   This tab allows to select the range (or ranges) of the timeline to export. By default, "session" is
146   enabled&mdash;this will export the whole session from the start marker to the end marker.
147   Any loop or range present in the session can be chosen, or a combination thereof.
148 </p>
149 <p>
150   The realtime checkboxes allow to export audio as it is played,
151   and not freewheeling to render the file as fast as Ardour can. This can prevent
152   odd behaviours from some plugins (reverbs, etc...). This can be chosen globally
153   (with the <kbd class="option">Realtime Export</kbd> checkbox at the top) or individually on a per time span basis, with
154   the <kbd class="option">RT</kbd> checkbox next to each time span.
155 </p>
156
157 <h2>Channels</h2>
158
159 <figure>
160   <img src="/images/export-dialog-channels.png" alt="The Channels tab">
161   <figcaption>
162     The Channels tab
163   </figcaption>
164 </figure>
165
166 <p>
167   This tab decides which outputs (tracks or busses) should be sent to the exported
168   file. By default, only the Master Bus is sent.
169 </p>
170
171 <h2>Stem Export</h2>
172
173 <figure>
174   <img src="/images/export-dialog-stem-export.png" alt="Stem export">
175   <figcaption>
176     Stem export
177   </figcaption>
178 </figure>
179
180 <p>
181   Stem exporting allows to transfer files between different systems and softwares
182   by exporting each track individually, including silence, to keep them in sync.
183 </p>
184 <p>
185   If 'Stem Export' is chosen, the 'Channels' tab appears slightly differently:
186   in this case each chosen channel (track or bus) is exported to its own file,
187   instead of all channels being mixed together into a single file.
188 </p>
189 <p>
190   The exported tracks or busses can, by checking <kbd class="option">Apply
191   track/bus processing</kbd>, be exported with the effects/processors applied,
192   so that the destination system does not need those effects plugins.
193 </p>