<tdalign=right><pclass=tiny>vorbisfile version 1.68 - 20030307</p></td>
<tdalign=right><pclass=tiny>vorbisfile version 1.2.0 - 20070723</p></td>
</tr>
</table>
...
...
@@ -50,16 +50,33 @@ int main(){
</tr>
</table>
<p><ahref="ov_open.html">ov_open()</a> must be
called to initialize the <ahref="OggVorbis_File.html">OggVorbis_File</a> structure with default values.
<ahref="ov_open.html">ov_open()</a> also checks to ensure that we're reading Vorbis format and not something else.
<p>This example takes its input on stdin which is in 'text' mode by default under Windows; this will corrupt the input data unless set to binary mode. This applies only to Windows.
<tt>fclose()</tt> on a file handle successfully submitted to <a
href="ov_open.html">ov_open()</a>; libvorbisfile does this in the <a
href="ov_clear.html">ov_clear()</a> call.<p>
An application that requires more setup flexibility may open a data
stream using <ahref="ov_open_callbacks.html">ov_open_callbacks()</a>
to change default libvorbis behavior or specify non-stdio data access
mechanisms.<p>
<p>
All libvorbisfile initialization and deallocation routines are declared in "vorbis/vorbisfile.h".
...
...
@@ -37,13 +48,18 @@ All libvorbisfile initialization and deallocation routines are declared in "vorb
<td><b>purpose</b></td>
</tr>
<trvalign=top>
<td><ahref="ov_open.html">ov_open</a></td>
<td>Initializes the Ogg Vorbis bitstream with a pointer to a bitstream and default values. This must be called before other functions in the library may be
<td><ahref="ov_fopen.html">ov_fopen</a></td>
<td>Opens a file and initializes the Ogg Vorbis bitstream with default values. This must be called before other functions in the library may be
used.</td>
</tr>
<trvalign=top>
<td><ahref="ov_open.html">ov_open</a></td>
<td>Initializes the Ogg Vorbis bitstream with default values from a passed in file handle. This must be called before other functions in the library may be
used. <ahref="#winfoot"><em>Do not use this call under Windows [a];</em></a> Use <ahref="ov_fopen.html">ov_fopen()</a> or <ahref="ov_open_callbacks.html">ov_open_callbacks()</a> instead.</td>
<td>Initializes the Ogg Vorbis bitstream with a pointer to a bitstream, default values, and custom file/bitstream manipulation routines. Used instead of <ahref="ov_open.html">ov_open()</a>when working with other than stdio based I/O.</td>
<td>Initializes the Ogg Vorbis bitstream from a file handle and custom file/bitstream manipulation routines. Used instead of <ahref="ov_open.html">ov_open()</a>or <ahref="ov_fopen.html">ov_fopen()</a> when altering or replacing libvorbis's default stdio I/O behavior, or when a bitstream must be initialized from a <tt>FILE *</tt> under Windows.</td>
</tr>
<trvalign=top>
...
...
@@ -86,13 +102,14 @@ Finish opening a file after a successful call to <a href="ov_test.html">ov_test(