manual/xml/using_existing_audio.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2
   3 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   4 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
   5
   6 <chapter id="ch-using-existing-audio">
   7   <title>Using Existing Audio</title>
   8   <para>
   9     There are two primary ways to bring data into Ardour: recording it
  10     within a session from a live sound source or importing pre-existing
  11     audio files. This section covers the various ways to import audio into a
  12     session.
  13   </para>
  14
  15   <section id="importing-and-embedding">
  16     <title>Importing and Embedding</title>
  17     <para>
  18       Importing and embedding are two different methods of using existing
  19       audio files on your computer (or network file system) within a
  20       session. They differ in one key respect:
  21     </para>
  22
  23     <variablelist>
  24       <varlistentry>
  25         <term>Importing</term>
  26         <listitem>
  27           <para>
  28             An existing audio file is copied to the session's sounds folder,
  29             and is converted into the session's native format (WAVE or
  30             Broadcast WAVE depending on your choice) and sample rate. At
  31             this time, no control over the conversion process is offered. If
  32             sample rate conversion is required, it will be carried out at
  33             the highest quality that Ardour can provide. This means that it
  34             can be rather slow (many minutes to import an audio file lasting
  35             a few minutes).
  36           </para>
  37         </listitem>
  38       </varlistentry>
  39
  40       <varlistentry>
  41         <term>Embedding</term>
  42         <listitem>
  43           <para>
  44             An existing audio file is used as a the source for a region, but
  45             is not copied or modified in any way.
  46           </para>
  47         </listitem>
  48       </varlistentry>
  49     </variablelist>
  50   </section>
  51
  52   <section id="supported-external-audio-file-formats">
  53     <title>Supported External Audio File Formats</title>
  54     <para>
  55       The list of audio file formats that Ardour can import/embed is quite
  56       long. It is based on the functionality offered by libsndfile, an
  57       excellent and widely used software library by Australian programmer
  58       Erik de Castro Lopo. As libsndfile's capabilities expand, so will
  59       Ardour's abilities to import (and export) new formats. Ogg/Vorbis (an
  60       excellent, unpatented and license free audio compression format
  61       similar to MP3) is planned for the near future. Currently, supported
  62       formats include:
  63     </para>
  64
  65     <itemizedlist>
  66       <listitem>
  67         <para>
  68           Microsoft WAV
  69         </para>
  70       </listitem>
  71
  72       <listitem>
  73         <para>
  74           SGI/Apple AIFF/AIFC
  75         </para>
  76       </listitem>
  77
  78       <listitem>
  79         <para>
  80           Sun AU/Snd
  81         </para>
  82       </listitem>
  83
  84       <listitem>
  85         <para>
  86           Raw (headerless)
  87         </para>
  88       </listitem>
  89
  90       <listitem>
  91         <para>
  92           Paris Audio File (PAF)
  93         </para>
  94       </listitem>
  95
  96       <listitem>
  97         <para>
  98           Commodore IFF/SVX
  99         </para>
 100       </listitem>
 101
 102       <listitem>
 103         <para>
 104           Sphere/NIST WAV
 105         </para>
 106       </listitem>
 107
 108       <listitem>
 109         <para>
 110           IRCAM SF
 111         </para>
 112       </listitem>
 113
 114       <listitem>
 115         <para>
 116           Creative VOC
 117         </para>
 118       </listitem>
 119
 120       <listitem>
 121         <para>
 122           SoundForge W64
 123         </para>
 124       </listitem>
 125
 126       <listitem>
 127         <para>
 128           GNU Octave MAT4.4
 129         </para>
 130       </listitem>
 131
 132       <listitem>
 133         <para>
 134           Portable Voice Format
 135         </para>
 136       </listitem>
 137
 138       <listitem>
 139         <para>
 140           Fasttracker 2 XI
 141         </para>
 142       </listitem>
 143
 144       <listitem>
 145         <para>
 146           HMM Tool Kit HTK
 147         </para>
 148       </listitem>
 149     </itemizedlist>
 150
 151     <para>
 152       Sample encodings supported include:
 153     </para>
 154
 155     <itemizedlist>
 156       <listitem>
 157         <para>
 158           Unsigned and signed 8, 16, 24 and 32 bit PCM
 159         </para>
 160       </listitem>
 161
 162       <listitem>
 163         <para>
 164           IEEE 32 and 64 floating point
 165         </para>
 166       </listitem>
 167
 168       <listitem>
 169         <para>
 170           U-LAW
 171         </para>
 172       </listitem>
 173
 174       <listitem>
 175         <para>
 176           A-LAW
 177         </para>
 178       </listitem>
 179
 180       <listitem>
 181         <para>
 182           IMA ADPCM
 183         </para>
 184       </listitem>
 185
 186       <listitem>
 187         <para>
 188           MS ADPCM
 189         </para>
 190       </listitem>
 191
 192       <listitem>
 193         <para>
 194           GSM 6.10
 195         </para>
 196       </listitem>
 197
 198       <listitem>
 199         <para>
 200           G721/723 ADPCM
 201         </para>
 202       </listitem>
 203
 204       <listitem>
 205         <para>
 206           12/16/24 bit DWVW
 207         </para>
 208       </listitem>
 209
 210       <listitem>
 211         <para>
 212           OK Dialogic ADPCM
 213         </para>
 214       </listitem>
 215
 216       <listitem>
 217         <para>
 218           8/16 DPCM
 219         </para>
 220       </listitem>
 221     </itemizedlist>
 222   </section>
 223
 224   <section id="using-audio-files">
 225     <title>Using audio files as tracks or regions?</title>
 226     <para>
 227       When you want to use existing audio files in an Ardour session, the
 228       first choice you need to make is whether you want to bring the files
 229       in as tracks or as new regions. Consider the two following scenarios:
 230     </para>
 231
 232     <itemizedlist>
 233       <listitem>
 234         <para>
 235           you have an 8 track recording of existing material, with 1 audio
 236           file per track
 237         </para>
 238       </listitem>
 239
 240       <listitem>
 241         <para>
 242           you have a sample library containing 500 small audio files
 243         </para>
 244       </listitem>
 245     </itemizedlist>
 246
 247     <para>
 248       In the first case, your goal is probably to have 8 tracks (at least),
 249       with each track containing a single audio file. In the second case,
 250       its a lot more likely that you simply want to be able to use any of
 251       the samples easily, but do not want any tracks created as a direct
 252       result of the import/embed. It is very important that you understand
 253       this distinction: many new users think there should be a "simple" way
 254       to import existing audio without understanding that the goal of
 255       importing/embedding is not always the same.
 256     </para>
 257
 258     <para>
 259       Ardour provides two different options when importing. You can
 260       import/embed audio files as new tracks, or you can import/embed them
 261       into the region list, where they will be available as regions to put
 262       into new or existing tracks. You can also insert import/embed audio
 263       files directly into an existing track.
 264     </para>
 265   </section>
 266
 267   <section id="how-to-import-embed">
 268     <title>How to import/embed</title>
 269     <para>
 270       There are three pathways for importing/embedding an audio file into a
 271       session. One is initiated from the File menu, one is initiated from
 272       the track context menu, and one is initiated from the region list.
 273       These methods are all equivalent: they open the file import dialog.
 274       Once the dialog is open, you can choose to add new audio as new
 275       tracks, as regions in the region list, or as audio in the selected
 276       track. You can change this behavior once the dialog is opened.
 277     </para>
 278
 279     <para>
 280       <caution>
 281         <para>
 282           If you want to import a file directly into an existing track, you
 283           must have the track selected in the editor before beginning the
 284           import.
 285         </para>
 286       </caution>
 287       If you use Nautilus as your file manager, you can easily import files
 288       into your project by dragging them onto the desired track, then
 289       releasing the mouse button. The file will then be
 290       <link
 291     linkend="gt-embed">embedded</link> into your session.
 292     </para>
 293   </section>
 294
 295   <section id="how-to-embed-a-file">
 296     <title>Working with Tags</title>
 297     <para>
 298       A "tag" is bit of information, or <emphasis>metadata</emphasis>, that
 299       is associated with a data file. Specifically, tags are keywords or
 300       terms that you feel have some relevance to a particular soundfile.
 301       Ardour can store these tags in a seachable database so that you can
 302       quickly search for sounds based on the tags that you have assigned to
 303       them. For example you can assign the term "120bpm" to a sound, and
 304       then when you search for this tag, the file will appear in the search
 305       list. Tags are independent of the filename or anything else about the
 306       file. Tags, and the file paths that they are associated with, are
 307       stored in a file called "sfdb" in your Ardour user folder.
 308     </para>
 309
 310     <section id="embedding-via-the-region-list">
 311       <title>Adding tags to a file</title>
 312       <orderedlist>
 313         <listitem>
 314           <para>
 315             Select a file in the import dialog.
 316           </para>
 317         </listitem>
 318         <listitem>
 319           <para>
 320             Enter the tags in the box to the right labeled "Tags".
 321           </para>
 322         </listitem>
 323       </orderedlist>
 324       <para>
 325         Tags are stored when the input box loses focus, there is no reason
 326         to explicitly "save" them.
 327       </para>
 328     </section>
 329
 330     <section id="embedding-from-a-track">
 331       <title>Searching for files using tags</title>
 332       <orderedlist>
 333         <listitem>
 334           <para>
 335             Select the "Search Tags" tab on the import dialog.
 336           </para>
 337         </listitem>
 338         <listitem>
 339           <para>
 340             Enter the tag(s) to search for and press "Search".
 341           </para>
 342         </listitem>
 343       </orderedlist>
 344       <para>
 345         Files which have been "tagged" with the input terms will appear in
 346         the results window. You can audition these files and apply tags to
 347         them from this window.
 348       </para>
 349     </section>
 350   </section>
 351
 352   <section id="searching-freesound">
 353     <title>Searching Freesound for soundfiles (optional)</title>
 354     <para>
 355       Freesound (http://freesound.iua.upf.edu/) is an online database with
 356       thousands of soundfiles which can be freely used in many projects
 357       (visit Freesound for the exact licensing terms). Ardour has an option
 358       to download files directly from freesound directly from the import
 359       dialog. Freesound files are tagged with metadata which you can use to
 360       search for relevant sounds.
 361     </para>
 362
 363     <para>
 364       To enable the Freesound search engine inside Ardour, you must build
 365       Ardour with the option FREESOUND=yes, and you must have the "curl"
 366       library installed. This is currently optional but may later become a
 367       standard feature of Ardour.
 368     </para>
 369
 370     <para>
 371       To download files from Freesound, you must first register for a
 372       username and password on the freesound website. Enter this information
 373       into the text entry boxes, enter your tags to search for, and then
 374       click "Start Downloading". Ardour will begin downloading files, and
 375       the "Start Downloading" button will change to say "Cancel". Clicking
 376       the "Cancel" button will wait until the currently downloading file is
 377       finished, then the button will switch back to "Start Downloading". The
 378       button will also say "Start Downloading" once Ardour has downloaded
 379       all of the files that match the given tag. In the future there may be
 380       better indication of the file progress and better filtering on the
 381       filetypes that are downloaded.
 382     </para>
 383
 384     <para>
 385       If you later search for the same terms, you will see that the files
 386       appear in the list more quickly, because any files in the search set
 387       that are already downloaded won't have to be downloaded again.
 388     </para>
 389
 390     <para>
 391       Sounds that are downloaded from Freesound will automatically be given
 392       tags in Ardour that match their tags in the Freesound database. This
 393       means that once they are downloaded, Ardour can search for the local
 394       files very quickly using the "Search Tags" tab.
 395     </para>
 396   </section>
 397 <!--
 398         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 399                 href="Some_Subsection.xml" />
 400         -->
 401 </chapter>