1<html> 2 3<head> 4<title>Tremor - Vorbisfile Differences</title> 5<link rel=stylesheet href="style.css" type="text/css"> 6</head> 7 8<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff"> 9<table border=0 width=100%> 10<tr> 11<td><p class=tiny>Tremor documentation</p></td> 12<td align=right><p class=tiny>Tremor version 1.0 - 20020403</p></td> 13</tr> 14</table> 15 16<h1>Tremor / Vorbisfile API Differences</h1> 17 18<p> 19 20The Tremor libvorbisidec library exposes an API intended to be as 21similar as possible to the familiar 'vorbisfile' library included with 22the open source Vorbis reference libraries distributed for free by 23Xiph.org. Differences are summarized below.<p> 24 25<h2>OggVorbis_File structure</h2> 26 27The <tt>bittrack</tt> and <tt>samptrack</tt> fields in the <a 28href="OggVorbis_File.html">OggVorbis_File</a> structure are changed to 2964 bit integers in Tremor, from doubles in vorbisfile. 30 31<h2>Time-related seek and tell function calls</h2> 32 33The <a href="ov_time_total.html">ov_time_total()</a> and <a 34href="ov_time_tell.html">ov_time_tell()</a> functions return milliseconds as 3564 bit integers in Tremor. In vorbisfile, these functions returned 36seconds as doubles.<p> 37 38In Tremor, the <a href="ov_time_seek.html">ov_time_seek()</a> and <a 39href="ov_time_seek_page.html">ov_time_seek_page()</a> calls take 40seeking positions in milliseconds as 64 bit integers, rather than in 41seconds as doubles as in Vorbisfile.<p> 42 43<h2>Reading decoded data</h2> 44 45Tremor <a href="ov_read.html">ov_read()</a> always returns data as 46signed 16 bit interleaved PCM in host byte order. As such, it does not 47take arguments to request specific signedness, byte order or bit depth 48as in Vorbisfile.<p> 49 50Tremor does not implement <tt>ov_read_float()</tt>.<p> 51 52 53<br><br> 54<hr noshade> 55<table border=0 width=100%> 56<tr valign=top> 57<td><p class=tiny>copyright © 2002 Xiph.org</p></td> 58<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td> 59</tr><tr> 60<td><p class=tiny>Tremor documentation</p></td> 61<td align=right><p class=tiny>Tremor version 1.0 - 20020403</p></td> 62</tr> 63</table> 64 65</body> 66 67</html> 68