put back the bit about the bitstream index. Didn't realize it was
authorRalph Giles <giles@xiph.org>
Tue, 20 Mar 2001 08:04:05 +0000 (08:04 +0000)
committerRalph Giles <giles@xiph.org>
Tue, 20 Mar 2001 08:04:05 +0000 (08:04 +0000)
talking about the chaining index, rather than the logical bitstream
serialno.

svn path=/trunk/vorbis/; revision=1386

doc/vorbisfile/ov_read.html
lib/vorbisfile.c

index 227dd18..0905268 100644 (file)
    if the toplevel application didn't particularly care.  However, when we actually read audio back, we must be aware that multiple bitstream sections do not necessarily
    have to have the same number of channels or sampling rate.
 </p><p>
-   <tt>ov_read()</tt> passes back the logical bitstream number currently
+    <tt>ov_read()</tt> passes back the index of the sequential logical
+    bitstream currently being decoded along with the PCM data in order
+    that the toplevel application can take action on channel/sample rate
+    changes. This number will be incremented at chaining boundaries even
+    for non-seekable streams. For seekable streams, it represents the
+    actual chaining index within the physical bitstream.
+<tt>ov_read()</tt> passes back the logical bitstream number currently
    being decoded along with the PCM data in order that the toplevel
    application can take action on channel/sample rate changes.
 </p>
index af79077..7b91010 100644 (file)
@@ -11,7 +11,7 @@
  ********************************************************************
 
  function: stdio-based convenience library for opening/seeking/decoding
- last mod: $Id: vorbisfile.c,v 1.42 2001/03/20 07:39:07 giles Exp $
+ last mod: $Id: vorbisfile.c,v 1.43 2001/03/20 08:04:05 giles Exp $
 
  ********************************************************************/
 
@@ -1104,7 +1104,11 @@ int host_is_big_endian() {
 
    ov_read returns the sequential logical bitstream number currently
    being decoded along with the PCM data in order that the toplevel
-   application can take action on channel/sample rate changes.
+   application can take action on channel/sample rate changes.  This
+   number will be incremented even for streamed (non-seekable) streams
+   (for seekable streams, it represents the actual logical bitstream
+   index within the physical bitstream.  Note that the accessor
+   functions above are aware of this dichotomy).
 
    input values: buffer) a buffer to hold packed PCM data for return
                 length) the byte length requested to be placed into buffer