1<html> 2 3<head> 4<title>Tremor - Seeking</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>Seeking</h1> 17<p>Seeking functions allow you to specify a specific point in the stream to begin or continue decoding. 18<p> 19All libvorbisidec seeking routines are declared in "ivorbisfile.h". 20 21<p>Certain seeking functions are best suited to different situations. 22When speed is important and exact positioning isn't required, 23page-level seeking should be used. Note also that Vorbis files do not 24necessarily start at a sample number or time offset of zero. Do not 25be surprised if a file begins at a positive offset of several minutes 26or hours, such as would happen if a large stream (such as a concert 27recording) is chopped into multiple separate files. Requesting to 28seek to a position before the beginning of such a file will seek to 29the position where audio begins.<p> 30 31</ul> 32 33<table border=1 color=black width=50% cellspacing=0 cellpadding=7> 34<tr bgcolor=#cccccc> 35 <td><b>function</b></td> 36 <td><b>purpose</b></td> 37</tr> 38<tr valign=top> 39 <td><a href="ov_raw_seek.html">ov_raw_seek</a></td> 40 <td>This function seeks to a position specified in the compressed bitstream, specified in bytes.</td> 41</tr> 42<tr valign=top> 43 <td><a href="ov_pcm_seek.html">ov_pcm_seek</a></td> 44 <td>This function seeks to a specific audio sample number, specified in pcm samples.</td> 45</tr> 46<tr valign=top> 47 <td><a href="ov_pcm_seek_page.html">ov_pcm_seek_page</a></td> 48 <td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples.</td> 49</tr> 50<tr valign=top> 51 <td><a href="ov_time_seek.html">ov_time_seek</a></td> 52 <td>This function seeks to the specific time location in the bitstream, specified in integer milliseconds. Note that this differs from the reference vorbisfile implementation, which takes seconds as a float. </td> 53</tr> 54<tr valign=top> 55 <td><a href="ov_time_seek_page.html">ov_time_seek_page</a></td> 56 <td>This function seeks to the closest page preceding the specified time position in the bitstream, specified in integer milliseconds.</td> 57</tr> 58</table> 59 60<br><br> 61<hr noshade> 62<table border=0 width=100%> 63<tr valign=top> 64<td><p class=tiny>copyright © 2002 Xiph.org</p></td> 65<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td> 66</tr><tr> 67<td><p class=tiny>Tremor documentation</p></td> 68<td align=right><p class=tiny>Tremor version 1.0 - 20020403</p></td> 69</tr> 70</table> 71 72</body> 73 74</html> 75