From: Colin Fletcher Date: Fri, 4 Jul 2014 18:08:01 +0000 (+0100) Subject: Rudimentary documentation for the export dialog. X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6a24229a989d583a5329fadd0ee2cc6faf573567;p=ardour-manual Rudimentary documentation for the export dialog. --- diff --git a/_manual/07_working-with-sessions/09_metadata.html b/_manual/07_working-with-sessions/09_metadata.html new file mode 100644 index 0000000..702175e --- /dev/null +++ b/_manual/07_working-with-sessions/09_metadata.html @@ -0,0 +1,13 @@ +--- +layout: default +title: Metadata +--- + +

+Sessions can have various items of metadata attached to them, via +Session > Metadata > Edit Metadata... and +Session > Metadata > Import Metadata.... +

+ +

Edit Session Metadata Dialog

+ diff --git a/_manual/18_exporting/01_export-dialog.html b/_manual/18_exporting/01_export-dialog.html new file mode 100644 index 0000000..19ee28d --- /dev/null +++ b/_manual/18_exporting/01_export-dialog.html @@ -0,0 +1,74 @@ +--- +layout: default +title: Export Dialog +--- + +

+When you have finished mixing your session, you probably want to export it to a sound +file to burn to a CD, upload to the web, or whatever. Session > Export > Export to Audio file(s)... +shows the Export Dialog to do this. + +

+

+You can also export the outputs of multiple tracks & busses all at once via +Session > Export > Stem Export.... +

+ +

File Format

+ +

+This tab contains controls for the format of the exported audio file. +You can enable more than one format here, in which case each will be exported in turn. +Ardour is supplied with a list of export formats, including: +

+You can edit these formats, or create your own, with the "Edit Export Format Profile" dialog, which +appears when you click the "Edit" or "New" button to the right of the drop-down list of formats. +

+ +

+You can also create a 'Preset' consisting of one or more formats. Ardour provides some ready-made presets, too: + +

+

+ +

Time Span

+ +

+This tab allows you to select the range (or ranges) of the timeline to export. By default, "session" is +enabled - this will export the whole session from the start marker to the end marker. +

+ + +

Channels

+ +

+Here you can choose which outputs (tracks or busses) should be sent to the exported file. +

+ + +{% children %} + + diff --git a/_manual/18_exporting/02_edit-export-format-profile.html b/_manual/18_exporting/02_edit-export-format-profile.html new file mode 100644 index 0000000..a408f8a --- /dev/null +++ b/_manual/18_exporting/02_edit-export-format-profile.html @@ -0,0 +1,138 @@ +--- +layout: default +title: Export Format Profiles +--- + +

Export Format Profiles

+ +

+An Export Format Profile specifies the file format in which Ardour will export +audio files, and also other audio file export options. +

+ +

+Export Format Profiles are edited via the 'Edit Export Format Profile' dialog. +

+ + +

+

Normalize

+

+If enbled, peak levels of exported files will be normalized to the level chosen here. +

+ +

Trim/Add silence at start/end

+

+ +

+ +

Compatibility/Quality/File format/Sample rate

+

Compatibility

+

+Selecting an item in the 'Compatibility' column will display options in the +other columns that are incompatible with that item in red. +

+ +

Quality

+

+The appropriate item in the 'Quality' column will be highlighted when you +choose a file format. Clicking on items in the 'Quality' column currently +doesn't seem to do anything useful. +

+ +

File format

+

+This column contains a list of Ardour's supported export file types. Click on +the format you want to use. +

+ +

Sample rate

+

+You can explicitly choose the sample rate of your exported files here, or +choose 'Session rate' to export in the current session's sample rate, without +sample rate conversion. +

+ +

Sample rate conversion quality

+

+If your chosen sample rate does not match the current session's sample rate, +choose the sample rate conversion quality here. Better quality options are +slower. +

+ +

Options

+

+Options relevant to the chosen file format will appear here. +Categories of audio file format are: +

+ +

+Available options include a selection of the following:

+ +

Sample Format

+

+Choose the bit depth of exported files. +

+ +

Dithering

+

+If the exported files bit depth is less than Ardour's native bit depth, +choose the dithering algorithm to use. +

+ +

Create CUE file/Create TOC file

+

+As well as exporting an audio file, create a file (in CUE or TOC format +respectively) containg CD track information, as defined in the +Ranges & Marks List. + + +

Tag with session's metadata

+

+If the exported file format supports metadata, use data entered in the +Session Metadata +window to tag the exported files. +

+ + +

Label

+

+The 'Label' field lets you choose the name which will be shown for this format +in the drop-down list of export formats in the 'File Formats' tab of the +Export dialog. + +

Command to run post-export

+

+If this is not blank, it is considered as a command to be run after the export +of each file. Either the command must exist in $PATH, or you can specify an +absolute path to an executable file here. +

+ +

+Certain sequences are allowed here to stand for the exported file name and the +like. Currently these are: +

+
%f
+
Full path & filename of the exported audio file
+
%d
+
Directory containing the exported audio file (including trailing directory separator)
+
%b
+
Basename of the exported audio file (without extension)
+
%s
+
Path to the current session file
+
%n
+
Name of the current session file
+
%%
+
A literal percent sign
+
+

+Any pert of the command-line enclosed in double-quotes (") will be used as-is. + +{% children %} + + diff --git a/source/ardour/manual/html/screenshots/edit-export-format-profile.png b/source/ardour/manual/html/screenshots/edit-export-format-profile.png new file mode 100644 index 0000000..f2fdbc5 Binary files /dev/null and b/source/ardour/manual/html/screenshots/edit-export-format-profile.png differ diff --git a/source/ardour/manual/html/screenshots/edit-session-metadata.png b/source/ardour/manual/html/screenshots/edit-session-metadata.png new file mode 100644 index 0000000..8a9f2df Binary files /dev/null and b/source/ardour/manual/html/screenshots/edit-session-metadata.png differ diff --git a/source/ardour/manual/html/screenshots/export-dialog-channels.png b/source/ardour/manual/html/screenshots/export-dialog-channels.png new file mode 100644 index 0000000..134ea42 Binary files /dev/null and b/source/ardour/manual/html/screenshots/export-dialog-channels.png differ diff --git a/source/ardour/manual/html/screenshots/export-dialog-file-format.png b/source/ardour/manual/html/screenshots/export-dialog-file-format.png new file mode 100644 index 0000000..f3de561 Binary files /dev/null and b/source/ardour/manual/html/screenshots/export-dialog-file-format.png differ diff --git a/source/ardour/manual/html/screenshots/export-dialog-timespan.png b/source/ardour/manual/html/screenshots/export-dialog-timespan.png new file mode 100644 index 0000000..c223ce1 Binary files /dev/null and b/source/ardour/manual/html/screenshots/export-dialog-timespan.png differ