]> Shamusworld >> Repos - ardour-manual/blob - include/export-dialog.html
Spelling & grammar fixes
[ardour-manual] / include / export-dialog.html
1
2 <p>
3   When you have finished mixing your session, you probably want 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 <p>
9   You can also export the outputs of multiple tracks and busses all at once via
10   <kbd class="menu">Session &gt; Export &gt; Stem Export&hellip;</kbd>.
11 </p>
12
13 <h2>File Format</h2>
14
15 <figure>
16   <img src="/images/export-dialog-file-format.png" alt="The Export window">
17   <figcaption>
18     The Export window
19   </figcaption>
20 </figure>
21
22 <p>
23   This tab contains controls for the format of the exported audio file.
24   You can enable more than one format 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>CD (Red Book)</li>
30 <li>DVD-A</li>
31 <li>FLAC 24 bit </li>
32 <li>FLAC 24 bit (tagged)</li>
33 <li>Ogg_Vorbis</li>
34 <li>Ogg_Vorbis (tagged)</li>
35 <li>Ring Tone</li>
36 </ul>
37
38 <p>
39   You can edit these formats, or create your own, with the <a href="@@export-format-profiles">"Edit Export Format Profile"</a> dialog, which
40   appears when you click the "Edit" or "New" button to the right of the drop-down list of formats.
41 </p>
42
43 <p>
44   You can also create a 'Preset' consisting of one or more formats. Ardour provides some ready-made presets, too:
45 </p>
46
47 <ul>
48 <li>CD + DVD-A</li>
49 <li>CD + FLAC</li>
50 <li>CD + FLAC (tagged)</li>
51 <li>CD + Ogg_Vorbis + FLAC (tagged)</li>
52 <li>CD + Ogg_Vorbis</li>
53 <li>CD + Ogg_Vorbis (tagged)</li>
54 <li>CD only</li>
55 <li>DVD-A only</li>
56 <li>FLAC</li>
57 <li>FLAC (tagged)</li>
58 <li>Ogg_Vorbis + FLAC</li>
59 <li>Ogg_Vorbis + FLAC (tagged)</li>
60 <li>Ogg_Vorbis </li>
61 <li>Ogg_Vorbis (tagged)</li>
62 </ul>
63
64 <h2>The location</h2>
65
66 <p>
67   Aside from providing a way to tell Ardour <em>where</em> to put the created file(s),
68   the <dfn>location</dfn> part of the window allows to name the exported files with
69   a lot of choice regarding the naming convention, hence blending into the user's
70   workflow, and providing a clean way to keep the export folders from being cluttered
71   with poorly named files.
72 </p>
73 <p>
74   The name of the file(s) can optionally be made of:
75 </p>
76
77 <ul>
78   <li>The session or snapshot's name</li>
79   <li>A custom label (i.e., any text)</li>
80   <li>A revision number</li>
81   <li>The name of the timespan (see below)</li>
82   <li>A date (in multiple formats)</li>
83   <li>A time (also in multiple format).</li>
84 </ul>
85
86 <h2>Soundcloud upload</h2>
87 <p>
88   When 'Upload to Soundcloud' is ticked on in any format's tab, a pane containing fields
89   to enter in Soundcloud account details (email and password), and what should happen
90   to the uploaded files will become visible.
91 </p>
92
93 <figure>
94   <img src="/images/soundcloud-upload.png" alt="Exporting to Soundcloud">
95   <figcaption>
96     Exporting to Soundcloud
97   </figcaption>
98 </figure>
99
100 <table class="dl">
101   <tr><th>Make files public</th>
102       <td>Choose whether to make uploaded files available to anyone via the Soundcloud web site.</td></tr>
103   <tr><th>Open uploaded files in browser</th>
104       <td>Open each file on soundcloud in your browser after upload.
105       If you don't enable this, you can still see the URLs in the Log window.</td></tr>
106   <tr><th>Make files downloadable</th>
107       <td>Choose whether to allow downloading of files uploaded to Soundcloud.</td></tr>
108 </table>
109
110 <h2>Analyze exported audio</h2>
111
112 <figure>
113   <img src="/images/export-report-analysis.png" alt="The Export Report/Analysis window">
114   <figcaption>
115     The Export Report/Analysis window
116   </figcaption>
117 </figure>
118
119 <p>
120   Checking <kbd class="option">Analyze Exported Audio</kbd> shows the Export Report/Analysis
121   window. This provides a lot of useful information about the exported file:
122 </p>
123 <ul>
124   <li>the file name and location</li>
125   <li>its format</li>
126   <li>its channel count</li>
127   <li>its sample rate</li>
128   <li>its duration and timecode.</li>
129 </ul>
130 <p>
131   It also allows to <kbd class="menu">Play</kbd> the file, and the <kbd class="menu">
132   Open Folder</kbd> button gives a quick access to the place where it has been created.
133 </p>
134 <p>
135   The most prominent feature though, are the two generated views of the audio file
136   in time (waveform) and frequency (sonograph) domain, and the loudness
137   analysis, giving:
138 </p>
139 <ul>
140   <li>the Peak value</li>
141   <li>the True Peak value (to take inter sample peaks into account)</li>
142   <li>the Normalization Gain (if it has been applied)</li>
143   <li>the Integrated Loudness</li>
144   <li>the loudness range</li>
145   <li>a graph of the multiplicity of the peaks at the different loudness levels.</li>
146 </ul>
147
148 <h2>Time Span</h2>
149
150 <figure>
151   <img src="/images/export-dialog-timespan.png" alt="The Time Span tab">
152   <figcaption>
153     The Time Span tab
154   </figcaption>
155 </figure>
156
157 <p>
158   This tab allows you to select the range (or ranges) of the timeline to export. By default, "session" is
159   enabled&mdash;this will export the whole session from the start marker to the end marker.
160 </p>
161
162 <h2>Channels</h2>
163
164 <figure>
165   <img src="/images/export-dialog-channels.png" alt="The Channels tab">
166   <figcaption>
167     The Channels tab
168   </figcaption>
169 </figure>
170
171 <p>
172   Here you can choose which outputs (tracks or busses) should be sent to the exported file.
173 </p>
174
175 <h2>Stem Export</h2>
176
177 <figure>
178   <img src="/images/export-dialog-stem-export.png" alt="Stem export">
179   <figcaption>
180     Stem export
181   </figcaption>
182 </figure>
183
184 <p>
185   If you chose 'Stem Export', 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. You can
188   choose to export either the region contents or the track output here in this
189   case.
190 </p>
191