[xiph-cvs] cvs commit: vorbis/doc/vorbisfile crosslap.html ov_crosslap.html ov_pcm_seek_lap.html ov_pcm_seek_page_lap.html ov_raw_seek_lap.html ov_time_seek_lap.html ov_time_seek_page_lap.html OggVorbis_File.html callbacks.html chaining_example_c.html chainingexample.html datastructures.html decoding.html example.html exampleindex.html fileinfo.html index.html initialization.html ov_bitrate.html ov_bitrate_instant.html ov_callbacks.html ov_clear.html ov_comment.html ov_info.html ov_open.html ov_open_callbacks.html ov_pcm_seek.html ov_pcm_seek_page.html ov_pcm_tell.html ov_pcm_total.html ov_raw_seek.html ov_raw_tell.html ov_raw_total.html ov_read.html ov_read_float.html ov_seekable.html ov_serialnumber.html ov_streams.html ov_test.html ov_test_callbacks.html ov_test_open.html ov_time_seek.html ov_time_seek_page.html ov_time_tell.html ov_time_total.html overview.html reference.html return.html seekexample.html seeking.html seeking_example_c.html seeking_test_c.html threads.html vorbis_comment.html vor
Monty
xiphmont at xiph.org
Sat Mar 8 00:11:30 PST 2003
xiphmont 03/03/08 03:11:30
Modified: doc/vorbisfile OggVorbis_File.html callbacks.html
chaining_example_c.html chainingexample.html
datastructures.html decoding.html example.html
exampleindex.html fileinfo.html index.html
initialization.html ov_bitrate.html
ov_bitrate_instant.html ov_callbacks.html
ov_clear.html ov_comment.html ov_info.html
ov_open.html ov_open_callbacks.html
ov_pcm_seek.html ov_pcm_seek_page.html
ov_pcm_tell.html ov_pcm_total.html ov_raw_seek.html
ov_raw_tell.html ov_raw_total.html ov_read.html
ov_read_float.html ov_seekable.html
ov_serialnumber.html ov_streams.html ov_test.html
ov_test_callbacks.html ov_test_open.html
ov_time_seek.html ov_time_seek_page.html
ov_time_tell.html ov_time_total.html overview.html
reference.html return.html seekexample.html
seeking.html seeking_example_c.html
seeking_test_c.html threads.html
vorbis_comment.html vorbis_info.html
vorbisfile_example_c.html
Added: doc/vorbisfile crosslap.html ov_crosslap.html
ov_pcm_seek_lap.html ov_pcm_seek_page_lap.html
ov_raw_seek_lap.html ov_time_seek_lap.html
ov_time_seek_page_lap.html
Log:
Documentation updates to reflect crosslap API extentions
Revision Changes Path
1.5 +3 -3 vorbis/doc/vorbisfile/OggVorbis_File.html
Index: OggVorbis_File.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/OggVorbis_File.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- OggVorbis_File.html 2 Jul 2002 21:40:29 -0000 1.4
+++ OggVorbis_File.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -108,11 +108,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.3 +3 -3 vorbis/doc/vorbisfile/callbacks.html
Index: callbacks.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/callbacks.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- callbacks.html 7 Jul 2002 07:59:50 -0000 1.2
+++ callbacks.html 8 Mar 2003 08:11:28 -0000 1.3
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -100,11 +100,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +5 -5 vorbis/doc/vorbisfile/chaining_example_c.html
Index: chaining_example_c.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/chaining_example_c.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- chaining_example_c.html 20 Dec 2001 01:00:21 -0000 1.3
+++ chaining_example_c.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -73,11 +73,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +5 -5 vorbis/doc/vorbisfile/chainingexample.html
Index: chainingexample.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/chainingexample.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- chainingexample.html 20 Dec 2001 01:00:21 -0000 1.3
+++ chainingexample.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -145,11 +145,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/datastructures.html
Index: datastructures.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/datastructures.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- datastructures.html 2 Jul 2002 21:40:29 -0000 1.4
+++ datastructures.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -48,11 +48,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/decoding.html
Index: decoding.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/decoding.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- decoding.html 2 Jul 2002 21:40:29 -0000 1.4
+++ decoding.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -73,11 +73,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +4 -4 vorbis/doc/vorbisfile/example.html
Index: example.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/example.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- example.html 2 Jul 2002 21:40:29 -0000 1.4
+++ example.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,11 +9,11 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
-<h1>Example Code</h1>
+<h1>Decoding Example Code</h1>
<p>
The following is a run-through of the decoding example program supplied
@@ -192,11 +192,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.3 +5 -5 vorbis/doc/vorbisfile/exampleindex.html
Index: exampleindex.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/exampleindex.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- exampleindex.html 6 Nov 2000 00:06:47 -0000 1.2
+++ exampleindex.html 8 Mar 2003 08:11:28 -0000 1.3
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -26,11 +26,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/fileinfo.html
Index: fileinfo.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/fileinfo.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- fileinfo.html 2 Jul 2002 21:40:29 -0000 1.3
+++ fileinfo.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -82,11 +82,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +4 -4 vorbis/doc/vorbisfile/index.html
Index: index.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/index.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.html 2 Jul 2002 21:40:29 -0000 1.3
+++ index.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -30,17 +30,17 @@
<p>
<a href="overview.html">API overview</a><br>
<a href="reference.html">API reference</a><br>
-Example code<br>
+Code Examples<br>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/initialization.html
Index: initialization.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/initialization.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- initialization.html 2 Jul 2002 21:40:29 -0000 1.4
+++ initialization.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -88,11 +88,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/ov_bitrate.html
Index: ov_bitrate.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_bitrate.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_bitrate.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_bitrate.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -59,11 +59,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/ov_bitrate_instant.html
Index: ov_bitrate_instant.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_bitrate_instant.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_bitrate_instant.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_bitrate_instant.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -52,11 +52,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/ov_callbacks.html
Index: ov_callbacks.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_callbacks.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_callbacks.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_callbacks.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -65,11 +65,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_clear.html
Index: ov_clear.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_clear.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_clear.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_clear.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -51,11 +51,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_comment.html
Index: ov_comment.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_comment.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_comment.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_comment.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -10,7 +10,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -53,11 +53,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_info.html
Index: ov_info.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_info.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_info.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_info.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -51,11 +51,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/ov_open.html
Index: ov_open.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_open.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_open.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_open.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -102,11 +102,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/ov_open_callbacks.html
Index: ov_open_callbacks.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_open_callbacks.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_open_callbacks.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_open_callbacks.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -97,11 +97,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +17 -15 vorbis/doc/vorbisfile/ov_pcm_seek.html
Index: ov_pcm_seek.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_pcm_seek.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_pcm_seek.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_pcm_seek.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -46,33 +46,35 @@
<h3>Return Values</h3>
<blockquote>
+<ul>
<li>0 for success</li>
<li>
-nonzero indicates failure, described by several error codes:</li>
-<ul>
-<li>OV_ENOSEEK - Bitstream is not seekable.
-</li>
-<li>OV_EINVAL - Invalid argument value.
-</li>
-<li>OV_EREAD - A read from media returned an error.
-</li>
-<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
+nonzero indicates failure, described by several error codes:
+ <ul>
+ <li>OV_ENOSEEK - Bitstream is not seekable.
+ </li>
+ <li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
+ </li>
+ <li>OV_EREAD - A read from media returned an error.
+ </li>
+ <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
-</li>
-<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
-</li>
+ </li>
+ <li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
+ </li>
+ </ul></li>
</ul></blockquote>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.6 +18 -17 vorbis/doc/vorbisfile/ov_pcm_seek_page.html
Index: ov_pcm_seek_page.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_pcm_seek_page.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ov_pcm_seek_page.html 2 Jul 2002 21:40:29 -0000 1.5
+++ ov_pcm_seek_page.html 8 Mar 2003 08:11:28 -0000 1.6
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -47,34 +47,35 @@
<h3>Return Values</h3>
<blockquote>
-<li>
-0 for success</li>
+<ul>
+<li>0 for success</li>
<li>
-nonzero indicates failure, described by several error codes:</li>
-<ul>
-<li>OV_ENOSEEK - Bitstream is not seekable.
-</li>
-<li>OV_EINVAL - Invalid argument value.
-</li>
-<li>OV_EREAD - A read from media returned an error.
-</li>
-<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
+nonzero indicates failure, described by several error codes:
+ <ul>
+ <li>OV_ENOSEEK - Bitstream is not seekable.
+ </li>
+ <li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
+ </li>
+ <li>OV_EREAD - A read from media returned an error.
+ </li>
+ <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
-</li>
-<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
-</li>
+ </li>
+ <li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
+ </li>
+ </ul></li>
</ul></blockquote>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_pcm_tell.html
Index: ov_pcm_tell.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_pcm_tell.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_pcm_tell.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_pcm_tell.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -50,11 +50,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +3 -3 vorbis/doc/vorbisfile/ov_pcm_total.html
Index: ov_pcm_total.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_pcm_total.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_pcm_total.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_pcm_total.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -54,11 +54,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +21 -13 vorbis/doc/vorbisfile/ov_raw_seek.html
Index: ov_raw_seek.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_raw_seek.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_raw_seek.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_raw_seek.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -45,28 +45,36 @@
<h3>Return Values</h3>
<blockquote>
-<li>0 indicates success</li>
-<li>nonzero indicates failure, described by several error codes:</li>
<ul>
-<li>OV_ENOSEEK - Bitstream is not seekable.
-</li>
-<li>OV_EINVAL - Invalid argument value.
-</li>
-<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
-</li>
-</ul>
-</blockquote>
+<li>0 for success</li>
+
+<li>
+nonzero indicates failure, described by several error codes:
+ <ul>
+ <li>OV_ENOSEEK - Bitstream is not seekable.
+ </li>
+ <li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
+ </li>
+ <li>OV_EREAD - A read from media returned an error.
+ </li>
+ <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
+ corruption.
+ </li>
+ <li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
+ </li>
+ </ul></li>
+</ul></blockquote>
<p>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_raw_tell.html
Index: ov_raw_tell.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_raw_tell.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_raw_tell.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_raw_tell.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -50,11 +50,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_raw_total.html
Index: ov_raw_total.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_raw_total.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_raw_total.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_raw_total.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -55,11 +55,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.6 +3 -3 vorbis/doc/vorbisfile/ov_read.html
Index: ov_read.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_read.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ov_read.html 2 Jul 2002 21:40:29 -0000 1.5
+++ ov_read.html 8 Mar 2003 08:11:28 -0000 1.6
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -110,11 +110,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +4 -4 vorbis/doc/vorbisfile/ov_read_float.html
Index: ov_read_float.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_read_float.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_read_float.html 23 Jul 2002 13:33:58 -0000 1.4
+++ ov_read_float.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -88,8 +88,8 @@
<td><p class=tiny>copyright © 2002 vorbis team</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_seekable.html
Index: ov_seekable.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_seekable.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_seekable.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_seekable.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -50,11 +50,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_serialnumber.html
Index: ov_serialnumber.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_serialnumber.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_serialnumber.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_serialnumber.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -54,11 +54,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_streams.html
Index: ov_streams.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_streams.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_streams.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_streams.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -51,11 +51,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_test.html
Index: ov_test.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_test.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_test.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_test.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -76,11 +76,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_test_callbacks.html
Index: ov_test_callbacks.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_test_callbacks.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_test_callbacks.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_test_callbacks.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -77,11 +77,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_test_open.html
Index: ov_test_open.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_test_open.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_test_open.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_test_open.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -62,11 +62,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +20 -8 vorbis/doc/vorbisfile/ov_time_seek.html
Index: ov_time_seek.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_time_seek.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_time_seek.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_time_seek.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -45,23 +45,35 @@
<h3>Return Values</h3>
<blockquote>
-<li>
-0 for success</li>
+<ul>
+<li>0 for success</li>
<li>
-Nonzero for failure</li>
-</blockquote>
-
+nonzero indicates failure, described by several error codes:
+ <ul>
+ <li>OV_ENOSEEK - Bitstream is not seekable.
+ </li>
+ <li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
+ </li>
+ <li>OV_EREAD - A read from media returned an error.
+ </li>
+ <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
+ corruption.
+ </li>
+ <li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
+ </li>
+ </ul></li>
+</ul></blockquote>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +18 -18 vorbis/doc/vorbisfile/ov_time_seek_page.html
Index: ov_time_seek_page.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_time_seek_page.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ov_time_seek_page.html 2 Jul 2002 21:40:29 -0000 1.4
+++ ov_time_seek_page.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -46,35 +46,35 @@
<h3>Return Values</h3>
<blockquote>
-<li>
-0 for success</li>
+<ul>
+<li>0 for success</li>
<li>
-nonzero indicates failure, described by several error codes:</li>
-<ul>
-<li>OV_ENOSEEK - Bitstream is not seekable.
-</li>
-<li>OV_EINVAL - Invalid argument value.
-</li>
-<li>OV_EREAD - A read from media returned an error.
-</li>
-<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
+nonzero indicates failure, described by several error codes:
+ <ul>
+ <li>OV_ENOSEEK - Bitstream is not seekable.
+ </li>
+ <li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
+ </li>
+ <li>OV_EREAD - A read from media returned an error.
+ </li>
+ <li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
-</li>
-<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
-</li>
+ </li>
+ <li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
+ </li>
+ </ul></li>
</ul></blockquote>
-
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_time_tell.html
Index: ov_time_tell.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_time_tell.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_time_tell.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_time_tell.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -50,11 +50,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/ov_time_total.html
Index: ov_time_total.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/ov_time_total.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ov_time_total.html 2 Jul 2002 21:40:29 -0000 1.3
+++ ov_time_total.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -54,11 +54,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +4 -3 vorbis/doc/vorbisfile/overview.html
Index: overview.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/overview.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- overview.html 2 Jul 2002 21:40:29 -0000 1.4
+++ overview.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -38,6 +38,7 @@
<li><p>Threading and thread safety
<li><p><a href="callbacks.html">Using [non stdio] custom stream I/O
via callbacks</a>
+<li><p>Sample crosslapping
</ul>
<p>
@@ -46,11 +47,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +10 -4 vorbis/doc/vorbisfile/reference.html
Index: reference.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/reference.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- reference.html 2 Jul 2002 21:40:29 -0000 1.4
+++ reference.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -32,13 +32,19 @@
<br>
<b>Decoding</b><br>
<a href="ov_read.html">ov_read()</a><br>
+ov_crosslap()<br>
<br>
<b>Seeking</b><br>
<a href="ov_raw_seek.html">ov_raw_seek()</a><br>
<a href="ov_pcm_seek.html">ov_pcm_seek()</a><br>
<a href="ov_time_seek.html">ov_time_seek()</a><br>
<a href="ov_pcm_seek_page.html">ov_pcm_seek_page()</a><br>
-ov_time_seek_page()<br>
+ov_time_seek_page()<p>
+ov_raw_seek_lap()<br>
+ov_pcm_seek_lap()<br>
+ov_time_seek_lap()<br>
+ov_pcm_seek_page_lap()<br>
+ov_time_seek_page_lap()<br>
<br>
<b>File Information</b><br>
<a href="ov_bitrate.html">ov_bitrate()</a><br>
@@ -62,11 +68,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.2 +3 -3 vorbis/doc/vorbisfile/return.html
Index: return.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/return.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- return.html 2 Jul 2002 21:41:36 -0000 1.1
+++ return.html 8 Mar 2003 08:11:28 -0000 1.2
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -64,11 +64,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.3 +7 -7 vorbis/doc/vorbisfile/seekexample.html
Index: seekexample.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/seekexample.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- seekexample.html 6 Nov 2000 00:06:47 -0000 1.2
+++ seekexample.html 8 Mar 2003 08:11:28 -0000 1.3
@@ -8,12 +8,12 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
-<h1>Example Code</h1>
+<h1>Example Code: seeking</h1>
<p>
The following is a run-through of the seeking example program supplied
@@ -38,7 +38,7 @@
</tr>
</table>
-<p>Inside main(), we declare our primary OggVorbis_File structure. We also declare a other helpful variables to track our progress within the file.
+<p>Inside main(), we declare our primary OggVorbis_File structure. We also declare other helpful variables to track our progress within the file.
<br><br>
<table border=0 width=100% color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
@@ -126,11 +126,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.5 +37 -4 vorbis/doc/vorbisfile/seeking.html
Index: seeking.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/seeking.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- seeking.html 3 Jul 2002 09:23:58 -0000 1.4
+++ seeking.html 8 Mar 2003 08:11:28 -0000 1.5
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -26,7 +26,18 @@
or hours, such as would happen if a large stream (such as a concert
recording) is chopped into multiple separate files. Requesting to
seek to a position before the beginning of such a file will seek to
-the position where audio begins.<p>
+the position where audio begins.
+
+<p>As of vorbisfile version 1.68, seeking also optionally provides
+automatic crosslapping to eliminate clicks and other discontinuity
+artifacts at seeking boundaries. This fetaure is of particular
+interest to player and game developers implementing dynamic music and
+audio engines, or others looking for smooth transitions within a
+single sample or across multiple samples.<p>
+
+<p>Naturally, seeking is available only within a seekable file or
+stream. Seeking functions will return <tt>OV_ENOSEEK</tt> on
+nonseekable files and streams.
</ul>
@@ -55,17 +66,39 @@
<td>ov_time_seek_page</td>
<td>This function seeks to the closest page preceding the specified time position in the bitstream</td>
</tr>
+
+</tr>
+<tr valign=top>
+ <td>ov_raw_seek_lap</td>
+ <td>This function seeks to a position specified in the compressed bitstream, specified in bytes. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
+</tr>
+<tr valign=top>
+ <td>ov_pcm_seek_lap</td>
+ <td>This function seeks to a specific audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
+</tr>
+<tr valign=top>
+ <td>ov_pcm_seek_page_lap</td>
+ <td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
+</tr>
+<tr valign=top>
+ <td>ov_time_seek_lap</td>
+ <td>This function seeks to the specific time location in the bitstream, specified in seconds. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
+</tr>
+<tr valign=top>
+ <td>ov_time_seek_page_lap</td>
+ <td>This function seeks to the closest page preceding the specified time position in the bitstream. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
+</tr>
</table>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.3 +5 -5 vorbis/doc/vorbisfile/seeking_example_c.html
Index: seeking_example_c.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/seeking_example_c.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- seeking_example_c.html 6 Nov 2000 00:06:47 -0000 1.2
+++ seeking_example_c.html 8 Mar 2003 08:11:28 -0000 1.3
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -70,11 +70,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.3 +5 -5 vorbis/doc/vorbisfile/seeking_test_c.html
Index: seeking_test_c.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/seeking_test_c.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- seeking_test_c.html 6 Nov 2000 00:06:47 -0000 1.2
+++ seeking_test_c.html 8 Mar 2003 08:11:28 -0000 1.3
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -70,11 +70,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.2 +3 -3 vorbis/doc/vorbisfile/threads.html
Index: threads.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/threads.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- threads.html 2 Jul 2002 21:41:36 -0000 1.1
+++ threads.html 8 Mar 2003 08:11:28 -0000 1.2
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -37,11 +37,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/vorbis_comment.html
Index: vorbis_comment.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/vorbis_comment.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- vorbis_comment.html 2 Jul 2002 21:40:29 -0000 1.3
+++ vorbis_comment.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -57,11 +57,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +3 -3 vorbis/doc/vorbisfile/vorbis_info.html
Index: vorbis_info.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/vorbis_info.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- vorbis_info.html 2 Jul 2002 21:40:29 -0000 1.3
+++ vorbis_info.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -9,7 +9,7 @@
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -67,11 +67,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2002 Xiph.org</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
-<td align=right><p class=tiny>libVorbisfile version 1.65 - 20020702</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.4 +6 -6 vorbis/doc/vorbisfile/vorbisfile_example_c.html
Index: vorbisfile_example_c.html
===================================================================
RCS file: /usr/local/cvsroot/vorbis/doc/vorbisfile/vorbisfile_example_c.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- vorbisfile_example_c.html 20 Dec 2001 01:00:21 -0000 1.3
+++ vorbisfile_example_c.html 8 Mar 2003 08:11:28 -0000 1.4
@@ -8,8 +8,8 @@
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
@@ -72,7 +72,7 @@
case we (the app) cares. In this case, we don't. */
} else {
/* we don't bother dealing with sample rate changes, etc, but
- you'll have to*/
+ you'll have to */
fwrite(pcmout,1,ret,stdout);
}
}
@@ -93,11 +93,11 @@
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
-<td><p class=tiny>copyright © 2000 vorbis team</p></td>
+<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:<a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2"><a href="mailto:team at vorbis.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.html%2</a></p></td>
</tr><tr>
-<td><p class=tiny>vorbisfile documentation</p></td>
-<td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>
+<td><p class=tiny>Vorbisfile documentation</p></td>
+<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<p><p>1.1 vorbis/doc/vorbisfile/crosslap.html
Index: crosslap.html
===================================================================
<html>
<head>
<title>Vorbisfile - Sample Crosslapping</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>What is Crosslapping?</h1>
<p>Crosslapping blends two samples together using a window function,
such that any sudden discontinuities between the samples that may
cause clicks or thumps are eliminated or blended away. The technique
is nearly identical to how Vorbis internally splices together frames
of audio data during normal decode. API functions are provided to <a
href="ov_crosslap.html">crosslap transitions between seperate
streams</a>, or to crosslap when <a href="seeking.html">seeking within
a single stream</a>.
<h1>Why Crosslap?</h1>
<h2>The source of boundary clicks</h2>
<p>Vorbis is a lossy compression format such that any compressed
signal is at best a close approximation of the original. The
approximation may be very good (ie, indistingushable to the human
ear), but it is an approximation nonetheless. Even if a sample or set
of samples is contructed carefully such that transitions from one to
another match perfectly in the original, the compression process
introduces minute amplitude and phase errors. It's an unavoidable
result of such high compression rates.
<p>If an application transitions instantly from one sample to another,
any tiny discrepancy introduced in the lossy compression process
becomes audible as a stairstep discontinuity. Even if the discrepancy
in a normal lapped frame is only .1dB (usually far below the
threshhold of perception), that's a sudden cliff of 380 steps in a 16
bit sample (when there's a boundary with no lapping).
<h2>I thought Vorbis was gapless</h2>
<p>It is. Vorbis introduces no extra samples at the beginning or end
of a stream, nor does it remove any samples. Gapless encoding
eliminates 99% of the click, pop or outright blown speaker that would
occur if boundaries had gaps or made no effort to align
transitions. However, gapless encoding is not enough to entirely
eliminate stairstep discontinuities all the time for exactly the
reasons described above.
<p>Frame lapping, like Vorbis performs internally during continuous
playback, is necessary to eliminate that last epislon of trouble.
<h1>Easiest Crosslap</h1>
The easiest way to perform crosslapping in Vorbis is to use the
lapping functions with no other extra effort. These functions behave
identically to when lapping isn't used except to provide
at-least-very-good lapping results. Crosslapping will not introduce
any samples into or remove any samples from the decoded audio; the
only difference is that the transition is lapped. Lapping occurs from
the current PCM position (either in the old stream, or at the position
prior to calling a lapping seek) forward into the next
half-short-block of audio data to be read from the new stream or
position.
<p>Ideally, vorbisfile internally reads an extra frame of audio from
the old stream/position to perform lapping into the new
stream/position. However, automagic crosslapping works properly even
if the old stream/position is at EOF. In this case, the synthetic
post-extrapolation generated by the encoder to pad out the last block
with appropriate data (and avoid encoding a stairstep, which is
inefficient) is used for crosslapping purposes. Although this is
synthetic data, the result is still usually completely unnoticable
even in careful listening (and always preferable to a click or pop).
<p>Vorbisfile will lap between streams of differing numbers of
channels. Any extra channels from the old stream are ignored; playback
of these channels simply ends. Extra channels in the new stream are
lapped from silence. Vorbisfile will also lap between streams links
of differing sample rates. In this case, the sample rates are ignored
(no implicit resampling is done to match playback). It is up to the
application developer to decide if this behavior makes any sense in a
given context; in practical use, these default behaviors perform
sensibly.
<h1>Best Crosslap</h1>
<p>To acheive the best possible crosslapping results, avoid the case
where synthetic extrapolation data is used for crosslapping. That is,
design loops and samples such that a little bit of data is left over
in sample A when seeking to sample B. Normally, the end of sample A
and the beginning of B would overlap exactly; this allows
crosslapping to perform exactly as it would within vorbis when
stitching audio frames together into continuous decoded audio.
<p>The optimal amount of overlap is half a short-block, and this
varies by compression mode. Each encoder will vary in exact block
size selection; for vorbis 1.0, for -q0 through -q10 and 44kHz or
greater, a half-short block is 64 samples.
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>1.1 vorbis/doc/vorbisfile/ov_crosslap.html
Index: ov_crosslap.html
===================================================================
<html>
<head>
<title>Vorbisfile - function - ov_crosslap</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>ov_crosslap()</h1>
<p><i>declared in "vorbis/vorbisfile.h";</i></p>
<p>ov_crosslap overlaps and blends the boundary at a transition
between two seperate streams represented by seperate <a
href="OggVorbis_File.html">OggVorbis_File</a> structures. For lapping
transitions due to seeking within a single stream represented by a
single OggVorbis_File structure,
consider using the lapping versions of the <a
href="seeking.html">vorbisfile seeking functions</a> instead.
<p>ov_crosslap is used between the last (usually ov_read) call on
the old stream and the first ov_read from the new stream. Any
desired positioning of the new stream must occur before the call to
ov_crosslap() as a seek dumps all prior lapping information from a
stream's decode state. Crosslapping does not introduce or remove any
extraneous samples; positioning works exactly as if ov_crosslap was not
called.
<p>ov_crosslap will lap between streams of differing numbers of
channels. Any extra channels from the old stream are ignored; playback
of these channels simply ends. Extra channels in the new stream are
lapped from silence. ov_crosslap will also lap between streams links
of differing sample rates. In this case, the sample rates are ignored
(no implicit resampling is done to match playback). It is up to the
application developer to decide if this behavior makes any sense in a
given context; in practical use, these default behaviors perform
sensibly.
<br><br>
<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
<td>
<pre><b>
long ov_crosslap(OggVorbis_File *old, OggVorbis_File *new);
</b></pre>
</td>
</tr>
</table>
<h3>Parameters</h3>
<dl>
<dt><i>old</i></dt>
<dd>A pointer to the OggVorbis_File structure representing the origin stream from which to transition playback.</dd>
<dt><i>new</i></dt>
<dd>A pointer to the OggVorbis_File structure representing the stream with which playback continues.</dd>
</dl>
<p><h3>Return Values</h3>
<blockquote>
<dl>
<dt>OV_EINVAL</dt>
<dd>crosslap called with an OggVorbis_File structure that isn't open.</dd>
<dt>OV_EFAULT</dt>
<dd>internal error; implies a library bug or external heap corruption.</dd>
<dt>OV_EREAD</dt>
<dd> A read from media returned an error.</dd>
<dt>OV_EOF</dt>
<dd>indicates stream <tt>vf2</tt> is at end of file, or that <tt>vf1</tt> is at end of file immediately after a seek (making crosslap impossible as there's no preceeding decode state to crosslap).</dd>
<dt><i>0</i></dt>
<dd>success.</dd>
</dl>
</blockquote>
<p><p><br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>1.1 vorbis/doc/vorbisfile/ov_pcm_seek_lap.html
Index: ov_pcm_seek_lap.html
===================================================================
<html>
<head>
<title>Vorbisfile - function - ov_pcm_seek_lap</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>ov_pcm_seek_lap</h1>
<p><i>declared in "vorbis/vorbisfile.h";</i></p>
<p>Seeks to the offset specified (in pcm samples) within the physical bitstream. This variant of <a
href="ov_pcm_seek.html">ov_pcm_seek</a> also automatically
crosslaps the transition from the previous playback position into the
new playback position in order to eliminate clicking and boundary
discontinuities. Otherwise, usage and behavior is identical to <a
href="ov_pcm_seek.html">ov_pcm_seek</a>.
<p>ov_pcm_seek_lap also updates everything needed within the decoder,
so you can immediately call ov_read() and
get data from the newly seeked to position.
<p>ov_pcm_seek_lap will lap between logical stream links of differing
numbers of channels. Any extra channels from the origin of the seek
are ignored; playback of these channels simply ends. Extra channels at
the destination are lapped from silence. ov_pcm_seek_lap will also
lap between logical stream links of differing sample rates. In this
case, the sample rates are ignored (no implicit resampling is done to
match playback). It is up to the application developer to decide if
this behavior makes any sense in a given context; in practical use,
these default behaviors perform sensibly.
<p>This function only works for seekable streams.
<br><br>
<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
<td>
<pre><b>
int ov_pcm_seek_lap(OggVorbis_File *vf,ogg_int64_t pos);
</b></pre>
</td>
</tr>
</table>
<h3>Parameters</h3>
<dl>
<dt><i>vf</i></dt>
<dd>A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisfile
functions.</dd>
<dt><i>pos</i></dt>
<dd>Position in pcm samples to seek to in the bitstream.</dd>
</dl>
<p><h3>Return Values</h3>
<blockquote>
<ul>
<li>0 for success</li>
<li>
nonzero indicates failure, described by several error codes:
<ul>
<li>OV_ENOSEEK - Bitstream is not seekable.
</li>
<li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
</li>
<li>OV_EREAD - A read from media returned an error.
</li>
<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
</li>
<li>OV_EOF - Indicates stream is at end of file immediately after a seek
(making crosslap impossible as there's no preceeding decode state to crosslap).
</li>
<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
</li>
</ul></li>
</ul></blockquote>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>1.1 vorbis/doc/vorbisfile/ov_pcm_seek_page_lap.html
Index: ov_pcm_seek_page_lap.html
===================================================================
<html>
<head>
<title>Vorbisfile - function - ov_pcm_seek_page_lap</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>ov_pcm_seek_page_lap</h1>
<p><i>declared in "vorbis/vorbisfile.h";</i></p>
<p>Seeks to the closest page preceding the specified location (in pcm
samples) within the physical bitstream. This variant of <a
href="ov_pcm_seek_page.html">ov_pcm_seek_page</a> also automatically
crosslaps the transition from the previous playback position into the
new playback position in order to eliminate clicking and boundary
discontinuities. Otherwise, usage and behavior is identical to <a
href="ov_pcm_seek_page.html">ov_pcm_seek_page</a>.
<p>This function is faster than <a
href="ov_pcm_seek_lap.html">ov_pcm_seek_lap</a> because the function
can begin decoding at a page boundary rather than seeking through any
remaining samples before the specified location. However, it is less
accurate.
<p>ov_pcm_seek_page_lap also updates everything needed within the
decoder, so you can immediately call <a
href="ov_read.html">ov_read()</a> and get data from the newly seeked
to position.
<p>ov_pcm_seek_page_lap will lap between logical stream links of
differing numbers of channels. Any extra channels from the origin of
the seek are ignored; playback of these channels simply ends. Extra
channels at the destination are lapped from silence.
ov_pcm_seek_page_lap will also lap between logical stream links of
differing sample rates. In this case, the sample rates are ignored
(no implicit resampling is done to match playback). It is up to the
application developer to decide if this behavior makes any sense in a
given context; in practical use, these default behaviors perform
sensibly.
<p>This function only works for seekable streams.
<br><br>
<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
<td>
<pre><b>
int ov_pcm_seek_page_lap(OggVorbis_File *vf,ogg_int64_t pos);
</b></pre>
</td>
</tr>
</table>
<h3>Parameters</h3>
<dl>
<dt><i>vf</i></dt>
<dd>A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisfile
functions.</dd>
<dt><i>pos</i></dt>
<dd>Position in pcm samples to seek to in the bitstream.</dd>
</dl>
<p><h3>Return Values</h3>
<blockquote>
<ul>
<li>0 for success</li>
<li>
nonzero indicates failure, described by several error codes:
<ul>
<li>OV_ENOSEEK - Bitstream is not seekable.
</li>
<li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
</li>
<li>OV_EREAD - A read from media returned an error.
</li>
<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
</li>
<li>OV_EOF - Indicates stream is at end of file immediately after a seek
(making crosslap impossible as there's no preceeding decode state to crosslap).
</li>
<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
</li>
</ul></li>
</ul></blockquote>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>1.1 vorbis/doc/vorbisfile/ov_raw_seek_lap.html
Index: ov_raw_seek_lap.html
===================================================================
<html>
<head>
<title>Vorbisfile - function - ov_raw_seek_lap</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>ov_raw_seek_lap</h1>
<p><i>declared in "vorbis/vorbisfile.h";</i></p>
<p>Seeks to the offset specified (in compressed raw bytes) within the
physical bitstream. This variant of <a
href="ov_raw_seek.html">ov_raw_seek</a> also automatically crosslaps
the transition from the previous playback position into the new
playback position in order to eliminate clicking and boundary
discontinuities. Otherwise, usage and behavior is identical to <a
href="ov_raw_seek.html">ov_raw_seek</a>.
<p>When seek speed is a priority, but crosslapping is still desired,
this is the best seek funtion to use.
<p>ov_raw_seek_lap also updates everything needed within the decoder,
so you can immediately call ov_read() and
get data from the newly seeked to position.
<p>ov_raw_seek_lap will lap between logical stream links of differing
numbers of channels. Any extra channels from the origin of the seek
are ignored; playback of these channels simply ends. Extra channels at
the destination are lapped from silence. ov_raw_seek_lap will also
lap between logical stream links of differing sample rates. In this
case, the sample rates are ignored (no implicit resampling is done to
match playback). It is up to the application developer to decide if
this behavior makes any sense in a given context; in practical use,
these default behaviors perform sensibly.
<p>This function only works for seekable streams.
<p><br><br>
<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
<td>
<pre><b>
int ov_raw_seek_lap(OggVorbis_File *vf,long pos);
</b></pre>
</td>
</tr>
</table>
<h3>Parameters</h3>
<dl>
<dt><i>vf</i></dt>
<dd>A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisfile
functions.</dd>
<dt><i>pos</i></dt>
<dd>Position in compressed bytes to seek to in the bitstream.</dd>
</dl>
<p><h3>Return Values</h3>
<blockquote>
<ul>
<li>0 for success</li>
<li>
nonzero indicates failure, described by several error codes:
<ul>
<li>OV_ENOSEEK - Bitstream is not seekable.
</li>
<li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
</li>
<li>OV_EREAD - A read from media returned an error.
</li>
<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
</li>
<li>OV_EOF - Indicates stream is at end of file immediately after a seek
(making crosslap impossible as there's no preceeding decode state to crosslap).
</li>
<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
</li>
</ul></li>
</ul></blockquote>
<p>
<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>1.1 vorbis/doc/vorbisfile/ov_time_seek_lap.html
Index: ov_time_seek_lap.html
===================================================================
<html>
<head>
<title>Vorbisfile - function - ov_time_seek_lap</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>ov_time_seek_lap</h1>
<p><i>declared in "vorbis/vorbisfile.h";</i></p>
<p>For seekable
streams, ov_time_seek_lap seeks to the given time. This variant of <a
href="ov_time_seek.html">ov_time_seek</a> also automatically
crosslaps the transition from the previous playback position into the
new playback position in order to eliminate clicking and boundary
discontinuities. Otherwise, usage and behavior is identical to <a
href="ov_time_seek.html">ov_time_seek</a>.
<p>ov_time_seek_lap also updates everything needed within the decoder,
so you can immediately call ov_read() and
get data from the newly seeked to position.
<p>ov_time_seek_lap will lap between logical stream links of differing
numbers of channels. Any extra channels from the origin of the seek
are ignored; playback of these channels simply ends. Extra channels at
the destination are lapped from silence. ov_time_seek_lap will also
lap between logical stream links of differing sample rates. In this
case, the sample rates are ignored (no implicit resampling is done to
match playback). It is up to the application developer to decide if
this behavior makes any sense in a given context; in practical use,
these default behaviors perform sensibly.
<p> This function does not work for unseekable streams.
<p><br><br>
<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
<td>
<pre><b>
int ov_time_seek_lap(OggVorbis_File *vf, double s);
</b></pre>
</td>
</tr>
</table>
<h3>Parameters</h3>
<dl>
<dt><i>vf</i></dt>
<dd>Pointer to our already opened and initialized OggVorbis_File structure.</dd>
<dt><i>ms</i></dt>
<dd>Location to seek to within the file, specified in seconds.</dd>
</dl>
<p><h3>Return Values</h3>
<blockquote>
<ul>
<li>0 for success</li>
<li>
nonzero indicates failure, described by several error codes:
<ul>
<li>OV_ENOSEEK - Bitstream is not seekable.
</li>
<li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
</li>
<li>OV_EREAD - A read from media returned an error.
</li>
<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
</li>
<li>OV_EOF - Indicates stream is at end of file immediately after a seek
(making crosslap impossible as there's no preceeding decode state to crosslap).
</li>
<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
</li>
</ul></li>
</ul></blockquote>
<p><br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>1.1 vorbis/doc/vorbisfile/ov_time_seek_page_lap.html
Index: ov_time_seek_page_lap.html
===================================================================
<html>
<head>
<title>Vorbisfile - function - ov_time_seek_page_lap</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>
<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
<h1>ov_time_seek_page_lap</h1>
<p><i>declared in "vorbis/vorbisfile.h";</i></p>
<p>For seekable streams, ov_time_seek_page_lap seeks to the closest
full page preceeding the given time. This variant of <a
href="ov_time_seek_page.html">ov_time_seek_page</a> also automatically
crosslaps the transition from the previous playback position into the
new playback position in order to eliminate clicking and boundary
discontinuities. Otherwise, usage and behavior is identical to <a
href="ov_time_seek_page.html">ov_time_seek_page</a>.
<p>ov_time_seek_page_lap is faster than <a
href="ov_time_seek_lap.html">ov_time_seek_lap</a> because it doesn't
seek through the last few samples to reach an exact time, but it is
also less accurate. This should be used when speed is important, but
crosslapping is still desired.
<p>ov_time_seek_page_lap also updates everything needed within the
decoder, so you can immediately call <a
href="ov_read.html">ov_read()</a> and get data from the newly seeked
to position.
<p>ov_time_seek_page_lap will lap between logical stream links of
differing numbers of channels. Any extra channels from the origin of
the seek are ignored; playback of these channels simply ends. Extra
channels at the destination are lapped from silence.
ov_time_seek_page_lap will also lap between logical stream links of
differing sample rates. In this case, the sample rates are ignored
(no implicit resampling is done to match playback). It is up to the
application developer to decide if this behavior makes any sense in a
given context; in practical use, these default behaviors perform
sensibly.
<p>This function does not work for unseekable streams.
<br><br>
<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
<td>
<pre><b>
int ov_time_seek_page_lap(OggVorbis_File *vf, double s);
</b></pre>
</td>
</tr>
</table>
<h3>Parameters</h3>
<dl>
<dt><i>vf</i></dt>
<dd>Pointer to our already opened and initialized OggVorbis_File structure.</dd>
<dt><i>ms</i></dt>
<dd>Location to seek to within the file, specified in seconds.</dd>
</dl>
<p><h3>Return Values</h3>
<blockquote>
<ul>
<li>0 for success</li>
<li>
nonzero indicates failure, described by several error codes:
<ul>
<li>OV_ENOSEEK - Bitstream is not seekable.
</li>
<li>OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open.
</li>
<li>OV_EREAD - A read from media returned an error.
</li>
<li>OV_EFAULT - Internal logic fault; indicates a bug or heap/stack
corruption.
</li>
<li>OV_EOF - Indicates stream is at end of file immediately after a seek
(making crosslap impossible as there's no preceeding decode state to crosslap).
</li>
<li>OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt.
</li>
</ul></li>
</ul></blockquote>
<p><br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright © 2003 Xiph.org</p></td>
<td align=right><p class=tiny>Ogg Vorbis</p></td>
</tr><tr>
<td><p class=tiny>Vorbisfile documentation</p></td>
<td align=right><p class=tiny>vorbisfile version 1.68 - 20030307</p></td>
</tr>
</table>
</body>
</html>
<p><p>--- >8 ----
List archives: http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to '<a href="mailto:cvs-request at xiph.org?Subject=Re:%20[xiph-cvs]%20cvs%20commit:%20vorbis/doc/vorbisfile%20crosslap.html%20ov_crosslap.html%20ov_pcm_seek_lap.html%20ov_pcm_seek_page_lap.html%20ov_raw_seek_lap.html%20ov_time_seek_lap.html%20ov_time_seek_page_lap.html%20OggVorbis_File.html%20callbacks.html%20chaining_example_c.html%20chainingexample.html%20datastructures.html%20decoding.html%20example.html%20exampleindex.html%20fileinfo.html%20index.html%20initialization.html%20ov_bitrate.html%20ov_bitrate_instant.html%20ov_callbacks.html%20ov_clear.html%20ov_comment.html%20ov_info.html%20ov_open.html%20ov_open_callbacks.html%20ov_pcm_seek.html%20ov_pcm_seek_page.html%20ov_pcm_tell.html%20ov_pcm_total.html%20ov_raw_seek.html%20ov_raw_tell.html%20ov_raw_total.html%20ov_read.html%20ov_read_float.html%20ov_seekable.html%20ov_serialnumber.html%20ov_streams.html%20ov_test.html%20ov_test_callbacks.html%20ov_test_open.html%20ov_time_seek.html%20ov_time_seek_page.html%20ov_time_tell.html%20ov_time_total.html%20overview.h'
containing only the word 'unsubscribe' in the body. No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.
More information about the commits
mailing list