manual/xml/using_existing_audio.xml

   1 <?xml version="1.0" standalone="no"?>
   2
   3 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   4
   5 ]>
   6
   7 <chapter id="ch-using-existing-audio">
   8   <title>Using Existing Audio</title>
   9   <para>
  10     There are two primary ways to bring data into Ardour: recording it
  11     within a session from a live sound source or importing pre-existing
  12     audio files. This section covers the various ways to import audio into a
  13     session.
  14   </para>
  15
  16   <section id="importing-and-embedding">
  17     <title>Importing and Embedding</title>
  18     <para>
  19       Importing and embedding are two different methods of using existing
  20       audio files on your computer (or network file system) within a
  21       session. They differ in one key respect:
  22     </para>
  23
  24     <variablelist>
  25       <title></title>
  26       <varlistentry>
  27         <term>Importing</term>
  28         <listitem>
  29           <para>
  30             An existing audio file is copied to the session's sounds folder,
  31             and is converted into the session's native format (WAVE or
  32             Broadcast WAVE depending on your choice) and sample rate.
  33           </para>
  34         </listitem>
  35       </varlistentry>
  36
  37       <varlistentry>
  38         <term>Embedding</term>
  39         <listitem>
  40           <para>
  41             An existing audio file is used as a the source for a region, but
  42             is not copied or modified in any way.
  43           </para>
  44         </listitem>
  45       </varlistentry>
  46     </variablelist>
  47   </section>
  48
  49   <section id="supported-external-audio-file-formats">
  50     <title>Supported External Audio File Formats</title>
  51     <para>
  52       The list of audio file formats that Ardour can import/embed is quite
  53       long. It is based on the functionality offered by libsndfile, an
  54       excellent and widely used software library by Australian programmer
  55       Erik de Castro Lopo. As libsndfile's capabilities expand, so will
  56       Ardour's abilities to import (and export) new formats. Ogg/Vorbis (an
  57       excellent, unpatented and license free audio compression format
  58       similar to MP3) is planned for the near future. Currently, supported
  59       formats include:
  60     </para>
  61
  62     <itemizedlist>
  63       <listitem>
  64         <para>
  65           Microsoft WAV
  66         </para>
  67       </listitem>
  68
  69       <listitem>
  70         <para>
  71           SGI/Apple AIFF/AIFC
  72         </para>
  73       </listitem>
  74
  75       <listitem>
  76         <para>
  77           Sun AU/Snd
  78         </para>
  79       </listitem>
  80
  81       <listitem>
  82         <para>
  83           Raw (headerless)
  84         </para>
  85       </listitem>
  86
  87       <listitem>
  88         <para>
  89           Paris Audio File (PAF)
  90         </para>
  91       </listitem>
  92
  93       <listitem>
  94         <para>
  95           Commodore IFF/SVX
  96         </para>
  97       </listitem>
  98
  99       <listitem>
 100         <para>
 101           Sphere/NIST WAV
 102         </para>
 103       </listitem>
 104
 105       <listitem>
 106         <para>
 107           IRCAM SF
 108         </para>
 109       </listitem>
 110
 111       <listitem>
 112         <para>
 113           Creative VOC
 114         </para>
 115       </listitem>
 116
 117       <listitem>
 118         <para>
 119           SoundForge W64
 120         </para>
 121       </listitem>
 122
 123       <listitem>
 124         <para>
 125           GNU Octave MAT4.4
 126         </para>
 127       </listitem>
 128
 129       <listitem>
 130         <para>
 131           Portable Voice Format
 132         </para>
 133       </listitem>
 134
 135       <listitem>
 136         <para>
 137           Fasttracker 2 XI
 138         </para>
 139       </listitem>
 140
 141       <listitem>
 142         <para>
 143           HMM Tool Kit HTK
 144         </para>
 145       </listitem>
 146     </itemizedlist>
 147
 148     <para>
 149       Sample encodings supported include:
 150     </para>
 151
 152     <itemizedlist>
 153       <listitem>
 154         <para>
 155           Unsigned and signed 8, 16, 24 and 32 bit PCM
 156         </para>
 157       </listitem>
 158
 159       <listitem>
 160         <para>
 161           IEEE 32 and 64 floating point
 162         </para>
 163       </listitem>
 164
 165       <listitem>
 166         <para>
 167           U-LAW
 168         </para>
 169       </listitem>
 170
 171       <listitem>
 172         <para>
 173           A-LAW
 174         </para>
 175       </listitem>
 176
 177       <listitem>
 178         <para>
 179           IMA ADPCM
 180         </para>
 181       </listitem>
 182
 183       <listitem>
 184         <para>
 185           MS ADPCM
 186         </para>
 187       </listitem>
 188
 189       <listitem>
 190         <para>
 191           GSM 6.10
 192         </para>
 193       </listitem>
 194
 195       <listitem>
 196         <para>
 197           G721/723 ADPCM
 198         </para>
 199       </listitem>
 200
 201       <listitem>
 202         <para>
 203           12/16/24 bit DWVW
 204         </para>
 205       </listitem>
 206
 207       <listitem>
 208         <para>
 209           OK Dialogic ADPCM
 210         </para>
 211       </listitem>
 212
 213       <listitem>
 214         <para>
 215           8/16 DPCM
 216         </para>
 217       </listitem>
 218     </itemizedlist>
 219   </section>
 220
 221   <section id="using-audio-files">
 222     <title> Using audio files as tracks or regions? </title>
 223     <para>
 224       When you want to use existing audio files in an Ardour session, the
 225       first choice you need to make is whether you want to bring the files
 226       in as tracks or as new regions. Consider the two following scenarios:
 227     </para>
 228
 229     <itemizedlist>
 230       <listitem>
 231         <para>
 232           you have an 8 track recording of existing material, with 1 audio
 233           file per track
 234         </para>
 235       </listitem>
 236
 237       <listitem>
 238         <para>
 239           you have a sample library containing 500 small audio files
 240         </para>
 241       </listitem>
 242     </itemizedlist>
 243
 244     <para>
 245       In the first case, your goal is probably to have 8 tracks (at least),
 246       with each track containing a single audio file. In the second case,
 247       its a lot more likely that you simply want to be able to use any of
 248       the samples easily, but do not want any tracks created as a direct
 249       result of the import/embed. It is very important that you understand
 250       this distinction: many new users think there should be a "simple" way
 251       to import existing audio without understanding that the goal of
 252       importing/embedding is not always the same.
 253     </para>
 254
 255     <para>
 256       Ardour provides two different options when importing. You can
 257       import/embed audio files as new tracks, or you can import/embed them
 258       into the region list, where they will be available as regions to put
 259       into new or existing tracks. You can also insert import/embed audio
 260       files directly into an existing track.
 261     </para>
 262   </section>
 263
 264   <section id="importing-an-audio-file-as-a-new-track">
 265     <title> How to import an audio file as a new track </title>
 266     <para>
 267       Click on the <guimenuitem>Edit</guimenuitem> item in the editor's menu
 268       bar. From the popup menu that appears, choose <menuchoice>
 269       <guimenu>Import</guimenu> <guisubmenu>...as new tracks</guisubmenu>
 270       </menuchoice>. The Audio Library/File Chooser window will appear.
 271       After you have made your selection of files to import, click the
 272       button at the bottom of that window (it will say something like
 273       "Import selected regions as new tracks").
 274     </para>
 275   </section>
 276
 277   <section id="embedding-an-audio-file-as-a-new-track">
 278     <title> How to embed an audio file as a new track </title>
 279     <section id="embedding-an-audio-file-drag-and-drop">
 280       <title> Drag-n-Drop </title>
 281       <para>
 282         If you use a file manager such as Nautilus or Konqueror ((basically,
 283         any tool that uses standard "list-of-URL's" encoding for
 284         drag-n-drop)), the simplest method to import files as tracks is to
 285         drag-n-drop. Select the files you want to embed in the file manager,
 286         drag the selection into Ardour and drop it over an area of the
 287         editor's track/arrange display where there are no tracks. The files
 288         will be embedded as 1 new track per file.
 289       </para>
 290     </section>
 291
 292     <section id="embedding-audio-file-using-edit-menu">
 293       <title> Edit menu </title>
 294       <para>
 295         Click on the <guimenuitem>Edit</guimenuitem> item in the editor's
 296         menu bar. From the popup menu that appears, choose <menuchoice>
 297         <guimenu>Embed</guimenu> <guisubmenu>...as new tracks</guisubmenu>
 298         </menuchoice>. The Audio Library/File Chooser window will appear.
 299         After you have made your selection of files to embed, click the
 300         button at the bottom of that window (it will say something like
 301         "Embed selected regions as new tracks"). 1 new track will be created
 302         for each file.
 303       </para>
 304     </section>
 305   </section>
 306
 307   <section id="importing-audio-as-a-new-region">
 308     <title> Importing as a new region </title>
 309     <para></para>
 310   </section>
 311
 312   <section id="embedding-audio-as-a-new-region">
 313     <title> Embedding as a new region </title>
 314     <para></para>
 315
 316     <section id="embedding-audio-drag-and-drop">
 317       <title> Drag-n-Drop </title>
 318       <para></para>
 319     </section>
 320
 321     <section id="embedding-audio-region-list-menu">
 322       <title> Region List Menu </title>
 323       <para></para>
 324     </section>
 325   </section>
 326
 327   <section id="how-to-import-embed">
 328     <title>How to import/embed</title>
 329     <para>
 330       Begin by clicking on the titlebar of the region list in the editor
 331       window. Select <guimenuitem>Import</guimenuitem> from the menu that
 332       appears, and the Sound File Database will be displayed. See sfdb for
 333       more details on using this dialog.
 334     </para>
 335
 336     <para>
 337       Once you have found and selected the files you want to import, click
 338       the "Import Selected" button on the SFDB dialog. Each selected audio
 339       file will be copied into the session's sounds folder, converted into
 340       the session's native format and sample rate. One or more new regions
 341       will be placed in the "External" section of the region list, either
 342       one per channel of each file or, if "create multichannel regions" was
 343       selected in the SFBD dialog, one per file.
 344     </para>
 345
 346     <para>
 347       If you use Nautilus as your file manager, you can easily import files
 348       into your project by dragging them onto the desired track, then
 349       releasing the mouse button. The file will then be
 350       <link linkend="gt-embed">embedded</link> into your session.
 351     </para>
 352
 353     <para>
 354       At this time, no control over the conversion process is offered. If
 355       sample rate conversion is required, it will be carried out at the
 356       highest quality that Ardour can provide. This means that it can be
 357       rather slow (many minutes to import an audio file lasting a few
 358       minutes).
 359     </para>
 360   </section>
 361
 362   <section id="how-to-embed-a-file">
 363     <title> How to embed a file </title>
 364     <para>
 365       There are two pathways for embedding an audio file into a session. One
 366       is initiated from the region list, and simply creates one or more new
 367       regions. The other is initiated from a specific track, and not only
 368       adds regions to the region list, but also inserts them into the
 369       track's playlist.
 370     </para>
 371
 372     <section id="embedding-via-the-region-list">
 373       <title>Embedding via the region list</title>
 374       <orderedlist>
 375         <listitem>
 376           <para>
 377             click with 1 on the region list title bar.
 378           </para>
 379         </listitem>
 380         <listitem>
 381           <para>
 382             Select Import audio file from the menu that appears.
 383           </para>
 384         </listitem>
 385         <listitem>
 386           <para>
 387             The SFDB dialog appears.
 388           </para>
 389         </listitem>
 390         <listitem>
 391           <para>
 392             Select the files you want to import
 393           </para>
 394         </listitem>
 395         <listitem>
 396           <para>
 397             then click on the <guibutton>Embed Selected</guibutton> button.
 398           </para>
 399         </listitem>
 400       </orderedlist>
 401       <para>
 402         New regions are added to the External section of the region list.
 403       </para>
 404     </section>
 405
 406     <section id="embedding-from-a-track">
 407       <title>Embedding from a track</title>
 408       <orderedlist>
 409         <listitem>
 410           <para>
 411             in the track you want to add the audiofile to.The track context
 412             menu will appear.
 413           </para>
 414         </listitem>
 415         <listitem>
 416           <para>
 417             Select EditInsert external sndfile from this menu. The SFDB
 418             dialog appears.
 419           </para>
 420         </listitem>
 421         <listitem>
 422           <para>
 423             Select the files you want to import
 424           </para>
 425         </listitem>
 426         <listitem>
 427           <para>
 428             then click on the <guibutton>Embed Selected</guibutton> button.
 429           </para>
 430         </listitem>
 431       </orderedlist>
 432       <para>
 433         New regions are added to the "External" section of the region list,
 434         and one is inserted into the track from which the embed was started.
 435       </para>
 436     </section>
 437   </section>
 438 <!--
 439         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 440                 href="Some_Subsection.xml" />
 441         -->
 442 </chapter>