Shamusworld >> Repos - ardour-manual/blob - include/import-dialog.html

   1
   2 <figure class="right">
   3         <img src="/images/import-window.png" alt="The import window" width="50%">
   4         <figcaption>
   5                 The import window.
   6         </figcaption>
   7 </figure>
   8
   9 <p>
  10   Many sessions will require the use of <dfn>existing material</dfn>,
  11   whether it consists of audio and/or MIDI data. Using existing samples,
  12   loops and riffs from files stored on the system can be the basis for
  13   a new session, or a way to deepen and improve one that is already
  14   underway.
  15 </p>
  16 <p>
  17   Importing audio and MIDI data into the session is done with the
  18   <dfn>Add Existing Media</dfn> dialog, accessed either by the
  19   <kbd class="menu"> Session &gt; Import</kbd> menu or, if any tracks have
  20   already been added, by right-clicking on the canvas of the <dfn>Editor</dfn>
  21   window and choosing <kbd class="menu">Insert Existing Media</kbd>.
  22 </p>
  23
  24 <h2>The Soundfile Information Box</h2>
  25 <p>
  26   This box will display information about the currently selected file:
  27 </p>
  28 <ul>
  29   <li>number of channels,</li>
  30   <li>sample rate,</li>
  31   <li>file format,</li>
  32   <li>length,</li>
  33   <li>embedded timestamp (applies to some professional formats such as
  34   Broadcast WAVE), and</li>
  35   <li><a href="@@searching-for-files-using-tags">tags</a> (attached metadata to help categorize files in a library).</li>
  36 </ul>
  37 <p>
  38   If the sample rate differs from the current session rate, it is displayed
  39   in red, which indicates that the file must be resampled before
  40   importing.
  41 </p>
  42 <p>
  43   Resampling is controlled by the <kbd class="menu">Conversion quality</kbd>
  44   option described below.
  45 </p>
  46 <p>
  47
  48 </p>
  49
  50 <h2>Auditioner</h2>
  51 <p>
  52   Files can be auditioned before importing. The slider under the play and
  53   stop buttons allows to scrub around, a fader on the right side allows
  54   to control the playback volume.
  55 </p>
  56 <p>
  57   Auditioning MIDI files requires a MIDI instrument to be chosen in the <kbd class="menu">
  58   Instrument</kbd> dropdown list.
  59 </p>
  60
  61 <h2>Importing options</h2>
  62 <p>
  63   Through the <kbd class="menu">Add files&hellip;</kbd> option, imported files can be inserted in the session:
  64 </p>
  65 <table class="dl">
  66   <tr><th>as new tracks</th><td>automatically creates new tracks and import the files in it</td></tr>
  67   <tr><th>to region list</th><td>adds the files to the <a href="@@the-region-list">region list</a>, from where then can be manually dragged into a track</td></tr>
  68   <tr><th>as new tape tracks</th><td>adds the files as <a href="@@track-types">Tape tracks.</a></td></tr>
  69 </table>
  70 <p>
  71   The <kbd class="menu">Insert at</kbd> option chooses where in time the file will be imported, amongst:
  72 </p>
  73 <ul>
  74   <li>the <dfn>file timestamp</dfn> (if available, zero by default)</li>
  75   <li>at the <a href="@@edit-point-control"><dfn>edit point</dfn></a></li>
  76   <li>at the <dfn>playhead</dfn></li>
  77   <li>at the <dfn>session start</dfn>.</li>
  78 </ul>
  79 <p>
  80   The Channel <kbd class="menu">Mapping</kbd> option is only available for
  81   multi-channel files (i.e. all but mono ones). It is either
  82 </p>
  83 <table class="dl">
  84   <tr><th>one track/region per file</th><td>Creates a multi channel track for each imported file</td></tr>
  85   <tr><th>one track/region per channel</th><td>Creates only mono channels, as many as there are channels in the imported files</td></tr>
  86   <tr><th>sequence files</th><td>If multiple files are imported, they can be sequenced into a single track in the order of selection</td></tr>
  87 </table>
  88 <p>
  89   The <kbd class="menu">Conversion quality</kbd> drop-down controls the
  90   quality of the resampling process, if the sampling rate of the source file
  91   differs from the session rate.
  92 </p>
  93 <p>
  94   There are three MIDI-specific options as well. First off, you can set a track
  95   naming scheme:
  96 </p>
  97 <table class="dl">
  98   <tr><th>by track number</th><td>will automatically assign every track a name that consists of the imported file name and a track number</td></tr>
  99   <tr><th>by track name</th><td>will</td></tr>
 100   <tr><th>by instrument name</th><td>will</a></td></tr>
 101 </table>
 102 <p>
 103 <p>
 104   You can also optionally import a tempo map from a MIDI file.
 105   The <kbd class="menu">Use MIDI Tempo Map (if defined)</kbd> option appears
 106   when a MIDI file is selected in the file selection dialog.
 107 <p>
 108 <p>
 109   The last MIDI-specific option is <kbd class="menu">Import MIDI Markers
 110   (if any)</kbd>. If those are present in a MIDI file, they will be rendered
 111   right above MIDI clips on the canvas. Editing the MIDI markers is currently
 112   unavailable.
 113 </p>
 114 <figure class="right">
 115         <img src="/images/imported-midi-markers.png" alt="MIDI markers imported from a .mid file" width="75%">
 116         <figcaption>
 117                 MIDI markers imported from a .mid file
 118         </figcaption>
 119 </figure>
 120 </p>
 121 <p>
 122   Finally, and most importantly, the files can be linked or copied to the session
 123   with the <kbd class="option">Copy files to session</kbd> checkbox. Please read
 124   <a href="@@copying-versus-linking">Copying
 125   versus Linking</a> for details.
 126 </p>
 127