Imported Upstream version 11.5

1 files changed, 19 insertions, 4 deletions

diff --git a/extsnd.html b/extsnd.html
index aebe99f..60d3fd0 100644
--- a/extsnd.html
+++ b/extsnd.html
@@ -530,7 +530,7 @@ Extensions to Snd can be found in:
 <tr><td><a href="sndscm.html#singerdoc">singer</a></td>
     <td onmouseout="UnTip()" onmouseover="Tip(singer_doc_tip)">Perry Cook's vocal-tract physical model</td></tr>
 
-<tr><td bgcolor="#f2f4ff"><a href="sndscm.html#sndolddoc">snd6|7|8|9|10.scm</a></td>
+<tr><td bgcolor="#f2f4ff"><a href="sndscm.html#sndolddoc">snd6|7|8|9|10|11.scm</a></td>
     <td bgcolor="#f2f4ff"onmouseout="UnTip()" onmouseover="Tip(sndold_doc_tip)">Backwards compatibility</td></tr>
 
 <tr><td><a href="sndscm.html#snddiffdoc">snddiff</a></td>
@@ -3983,9 +3983,23 @@ mus-audio-read reads 'frames' frames of data into the sound-data object 'sd' fro
 
 
 <!-- mus-audio-write -->
-<tr><td colspan=2 bgcolor="#f2f4ff"><code><a class=def name="musaudiowrite">mus-audio-write</a> line sd frames</code>
+<tr><td colspan=2 bgcolor="#f2f4ff"><code><a class=def name="musaudiowrite">mus-audio-write</a> line sd frames (start 0)</code>
 </td></tr><tr><td></td><td>
-mus-audio-write writes 'frames' frames of data from the sound-data object 'sd' to the audio output port 'line'.
+<p>mus-audio-write writes 'frames' frames of data from the sound-data object 'sd' to the audio output port 'line'.
+If 'start' is given, it sets where to start reading in the sound-data buffers.
+</p>
+<pre>
+(let ((sd (make-sound-data 1 44100)))
+  (with-sound (:output sd)
+    (fm-violin 0 1 440 .1)
+    (fm-violin .5 .1 660 .1))
+
+  (let* ((audio-fd (mus-audio-open-output mus-audio-default 44100 1 mus-lfloat (* 4 1024))))
+    (do ((i 0 (+ i 1024)))
+	((&gt;= i 44100))
+      (mus-audio-write audio-fd sd 1024 i))
+    (mus-audio-close audio-fd)))
+</pre>
 </td></tr><tr><td colspan=2 height=16></td></tr>
 
 
@@ -5517,7 +5531,7 @@ The following calls are equivalent:
 Max length of region list: <a href="#maxregions">max-regions</a><br>
 Whether selection creates a region: <a href="#selectioncreatesregion">selection-creates-region</a><br>
 To play region repeatedly: <a href="sndscm.html#playregionforever">play-region-forever</a><br>
-Start region browser from Scheme: <a href="#viewregionsdialog">view-regions-dialog</a><br>
+Start region browser: <a href="#viewregionsdialog">view-regions-dialog</a><br>
 All about regions: <a href="snd.html#regions">regions</a><br>
 The region dialog: <a href="snd.html#regionbrowser">region browser</a><br>
 Region rms amp: <a href="sndscm.html#regionrms">region-rms</a><br>
@@ -7668,6 +7682,7 @@ Not all the keyword arguments apply in all cases, though I hope to fill in the t
 
 <pre>
     (play)                                                       ; play current sound, all chans from start to end
+    (play 0 :channel 1)                                          ; play just the second channel of sound 0
     (play ((selected-sound) <a class=quiet href="#cursor" onmouseout="UnTip()" onmouseover="Tip(extsnd_cursor_tip)">cursor</a>))                             ; play starting from the cursor
     (play (integer-&gt;sound 1) (round (* 3.0 (<a class=quiet href="#srate" onmouseout="UnTip()" onmouseover="Tip(extsnd_srate_tip)">srate</a>))) :channel 3) ; play snd 1, chan 3 (4th chan), start at 3.0 secs
     (play (selected-sound) 0 :with-sync #t)                      ; play sync'd sounds