]> Shamusworld >> Repos - ardour-manual/blob - include/import-dialog.html
Add fine mode for using mouse scroll
[ardour-manual] / include / import-dialog.html
1
2 <figure class="right">
3         <img src="/images/import-window.png" alt="The import window">
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 by the <kbd class="menu">
19   Session &gt; Import</kbd> menu.
20 </p>
21
22 <h2>The Soundfile Information Box</h2>
23 <p>
24   This box will display information about the currently selected file:
25 </p>
26 <ul>
27   <li>number of channels,</li>
28   <li>sample rate,</li>
29   <li>file format,</li>
30   <li>length,</li>
31   <li>embedded timestamp (applies to some professional formats such as
32   Broadcast WAVE), and</li>
33   <li><a href="@@searching-for-files-using-tags">tags</a> (attached metadata to help categorize files in a library).</li>
34 </ul>
35 <p>
36   If the sample rate differs from the current session rate, it is displayed
37   in red, which indicates that the file must be resampled before
38   importing.
39 </p>
40 <p>
41   Resampling is controlled by the <kbd class="menu">Conversion quality</kbd>
42   option described below.
43 </p>
44 <p>
45
46 </p>
47
48 <h2>Auditioner</h2>
49 <p>
50   Files can be auditioned before importing. The slider under the play and
51   stop buttons allows to scrub around, a fader on the right side allows
52   to control the playback volume.
53 </p>
54 <p>
55   Auditioning MIDI files requires a MIDI instrument to be chosen in the <kbd class="menu">
56   Instrument</kbd> dropdown list.
57 </p>
58
59 <h2>Importing options</h2>
60 <p>
61   Through the <kbd class="menu">Add files&hellip;</kbd> option, imported files can be inserted in the session:
62 </p>
63 <table class="dl">
64   <tr><th>as new tracks</th><td>automatically creates new tracks and import the files in it</td></tr>
65   <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>
66   <tr><th>as new tape tracks</th><td>adds the files as <a href="@@track-types">Tape tracks.</a></td></tr>
67 </table>
68 <p>
69   The <kbd class="menu">Insert at</kbd> option chooses where in time the file will be imported, amongst:
70 </p>
71 <ul>
72   <li>the <dfn>file timestamp</dfn> (if available, zero by default)</li>
73   <li>at the <a href="@@edit-point-control"><dfn>edit point</dfn></a></li>
74   <li>at the <dfn>playhead</dfn></li>
75   <li>at the <dfn>session start</dfn>.</li>
76 </ul>
77 <p>
78   The Channel <kbd class="menu">Mapping</kbd> option is only available for
79   multi-channel files (i.e. all but mono ones). It is either
80 </p>
81 <table class="dl">
82   <tr><th>one track/region per file</th><td>Creates a multi channel track for each imported file</td></tr>
83   <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>
84   <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>
85 </table>
86 <p>
87   The <kbd class="menu">Conversion quality</kbd> drop-down controls the
88   quality of the resampling process, if the sampling rate of the source file
89   differs from the session rate.
90 </p>
91 <p>
92   Finally, and most importantly, the the files can be linked or copied to the session
93   with the <kbd class="option">Copy files to session</kbd> checkbox. Please read
94   <a href="@@copying-versus-linking">Copying
95   versus Linking</a> for details.
96 </p>
97