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>
********************************************************************
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 $
********************************************************************/
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