2 <img class="right" src="/images/import-window.png" alt="The import window">
5 Many sessions will require the use of <dfn>existing material</dfn>,
6 whether it consists of audio and/or MIDI data. Using existing samples,
7 loops and riffs from files stored on your system can be the basis for
8 a new session, or a way to deepen and improve one that is already
12 Importing audio and MIDI data into the session is done with the
13 <dfn>Add Existing Media</dfn> dialog, accessed by the <kbd class="menu">
14 Session > Import</kbd> menu.
17 <h2>The Soundfile Information Box</h2>
19 This box will display information about the currently selected file:
22 <li>number of channels,</li>
26 <li>embedded timestamp (applies to some professional formats such as
27 Broadcast WAVE), and</li>
28 <li><a href="@@searching-for-files-using-tags">tags</a> (attached metadata to help categorize files in a library).</li>
31 If the sample rate differs from the current session rate, it is displayed
32 in red, which indicates that the file must be resampled before
36 Resampling is controlled by the <kbd class="menu">Conversion quality</kbd>
37 option described below.
45 Files can be auditioned before importing. The slider under the play and
46 stop buttons allows you to scrub around, a fader on the right side allows
47 to control the playback volume.
50 Auditionning MIDI files requires a MIDI instrument to be chosen in the <kbd class="menu">
51 Instrument</kbd> dropdown list.
54 <h2>Importing options</h2>
56 Through the <kbd class="menu">Add files…</kbd> option, imported files can be inserted in the session:
59 <tr><th>as new tracks</th><td>automatically creates new tracks and import the files in it</td></tr>
60 <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>
61 <tr><th>as new tape tracks</th><td>adds the files as <a href="@@track-types">Tape tracks.</a></td></tr>
64 The <kbd class="menu">Insert at</kbd> option chooses where in time the file will be imported, amongst:
67 <li>the <dfn>file timestamp</dfn> (if available, zero by default)</li>
68 <li>at the <a href="@@edit-point-control"><dfn>edit point</dfn></a></li>
69 <li>at the <dfn>playhead</dfn></li>
70 <li>at the <dfn>session start</dfn>.</li>
73 The Channel <kbd class="menu">Mapping</kbd> option is only available for
74 multi-channel files (i.e. all but mono ones). It is either
77 <tr><th>one track/region per file</th><td>Creates a multi channel track for each imported file</td></tr>
78 <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>
79 <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>
82 The <kbd class="menu">Conversion quality</kbd> drop-down controls the
83 quality of the resampling process, if the sampling rate of the source file
84 differs from the session rate.
87 Finally, and most importantly, the the files can be linked or copied to the session
88 with the <kbd class="option">Copy files to session</kbd> checkbox. Please read
89 <a href="@@copying-versus-linking">Copying
90 versus Linking</a> for details.