00001 <html>
00002
00003 <head>
00004 <title>Tremor - Vorbisfile Differences</title>
00005 <link rel=stylesheet href="style.css" type="text/css">
00006 </head>
00007
00008 <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
00009 <table border=0 width=100%>
00010 <tr>
00011 <td><p class=tiny>Tremor documentation</p></td>
00012 <td align=right><p class=tiny>Tremor version 1.0 - 20020403</p></td>
00013 </tr>
00014 </table>
00015
00016 <h1>Tremor / Vorbisfile API Differences</h1>
00017
00018 <p>
00019
00020 The Tremor libvorbisidec library exposes an API intended to be as
00021 similar as possible to the familiar 'vorbisfile' library included with
00022 the open source Vorbis reference libraries distributed for free by
00023 Xiph.org. Differences are summarized below.<p>
00024
00025 <h2>OggVorbis_File structure</h2>
00026
00027 The <tt>bittrack</tt> and <tt>samptrack</tt> fields in the <a
00028 href="OggVorbis_File.html">OggVorbis_File</a> structure are changed to
00029 64 bit integers in Tremor, from doubles in vorbisfile.
00030
00031 <h2>Time-related seek and tell function calls</h2>
00032
00033 The <a href="ov_time_total.html">ov_time_total()</a> and <a
00034 href="ov_time_tell.html">ov_time_tell()</a> functions return milliseconds as
00035 64 bit integers in Tremor. In vorbisfile, these functions returned
00036 seconds as doubles.<p>
00037
00038 In Tremor, the <a href="ov_time_seek.html">ov_time_seek()</a> and <a
00039 href="ov_time_seek_page.html">ov_time_seek_page()</a> calls take
00040 seeking positions in milliseconds as 64 bit integers, rather than in
00041 seconds as doubles as in Vorbisfile.<p>
00042
00043 <h2>Reading decoded data</h2>
00044
00045 Tremor <a href="ov_read.html">ov_read()</a> always returns data as
00046 signed 16 bit interleaved PCM in host byte order. As such, it does not
00047 take arguments to request specific signedness, byte order or bit depth
00048 as in Vorbisfile.<p>
00049
00050 Tremor does not implement <tt>ov_read_float()</tt>.<p>
00051
00052
00053 <br><br>
00054 <hr noshade>
00055 <table border=0 width=100%>
00056 <tr valign=top>
00057 <td><p class=tiny>copyright © 2002 Xiph.org</p></td>
00058 <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
00059 </tr><tr>
00060 <td><p class=tiny>Tremor documentation</p></td>
00061 <td align=right><p class=tiny>Tremor version 1.0 - 20020403</p></td>
00062 </tr>
00063 </table>
00064
00065 </body>
00066
00067 </html>
