Debian Codegraph @

doc/seeking.html

raw
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>
19 All libvorbisidec seeking routines are declared in "ivorbisfile.h".
20
21 <p>Certain seeking functions are best suited to different situations.
22 When speed is important and exact positioning isn't required,
23 page-level seeking should be used. Note also that Vorbis files do not
24 necessarily start at a sample number or time offset of zero. Do not
25 be surprised if a file begins at a positive offset of several minutes
26 or hours, such as would happen if a large stream (such as a concert
27 recording) is chopped into multiple separate files. Requesting to
28 seek to a position before the beginning of such a file will seek to
29 the 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 &copy; 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>