Update docs for the Add Existing Media dialog

diff --git a/include/import-dialog.html b/include/import-dialog.html
index 9fb0a5a9c89d675807d21132d5c13db73edbc9a5..3fb1d81d2f808221b4560e06aefe182874cd9144 100644 (file)
--- a/include/import-dialog.html
+++ b/include/import-dialog.html
@@ -1,6 +1,6 @@
 
 <figure class="right">
-       <img src="/images/import-window.png" alt="The import window">
+       <img src="/images/import-window.png" alt="The import window" width="50%">
        <figcaption>
                The import window.
        </figcaption>
@@ -15,8 +15,10 @@
 </p>
 <p>
   Importing audio and MIDI data into the session is done with the
-  <dfn>Add Existing Media</dfn> dialog, accessed by the <kbd class="menu">
-  Session &gt; Import</kbd> menu.
+  <dfn>Add Existing Media</dfn> dialog, accessed either by the
+  <kbd class="menu"> Session &gt; Import</kbd> menu or, if any tracks have
+  already been added, by right-clicking on the canvas of the <dfn>Editor</dfn>
+  window and choosing <kbd class="menu">Insert Existing Media</kbd>.
 </p>
 
 <h2>The Soundfile Information Box</h2>
@@ -88,6 +90,34 @@
   quality of the resampling process, if the sampling rate of the source file
   differs from the session rate.
 </p>
+<p>
+  There are three MIDI-specific options as well. First off, you can set a track 
+  naming scheme:
+</p>
+<table class="dl">
+  <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>
+  <tr><th>by track name</th><td>will</td></tr>
+  <tr><th>by instrument name</th><td>will</a></td></tr>
+</table>
+<p>
+<p>
+  You can also optionally import a tempo map from a MIDI file.
+  The <kbd class="menu">Use MIDI Tempo Map (if defined)</kbd> option appears
+  when a MIDI file is selected in the file selection dialog.
+<p>
+<p>
+  The last MIDI-specific option is <kbd class="menu">Import MIDI Markers
+  (if any)</kbd>. If those are present in a MIDI file, they will be rendered
+  right above MIDI clips on the canvas. Editing the MIDI markers is currently
+  unavailable.
+</p>
+<figure class="right">
+       <img src="/images/imported-midi-markers.png" alt="MIDI markers imported from a .mid file" width="75%">
+       <figcaption>
+               MIDI markers imported from a .mid file
+       </figcaption>
+</figure>
+</p>
 <p>
   Finally, and most importantly, the files can be linked or copied to the session
   with the <kbd class="option">Copy files to session</kbd> checkbox. Please read

diff --git a/source/images/import-window.png b/source/images/import-window.png
index 49d0525f8ad1368365c87156e58cb4ee1452d39c..f131e50177c5f0be8e3a07ef5bacb3fa04907d30 100644 (file)
Binary files a/source/images/import-window.png and b/source/images/import-window.png differ

diff --git a/source/images/imported-midi-markers.png b/source/images/imported-midi-markers.png
new file mode 100644 (file)
index 0000000..e695c41
Binary files /dev/null and b/source/images/imported-midi-markers.png differ