Merge branch_beta3 onto the mainline.
[platform/upstream/libvorbis.git] / doc / vorbisfile / seeking.html
1 <html>\r
2 \r
3 <head>\r
4 <title>vorbisfile - Seeking</title>\r
5 <link rel=stylesheet href="style.css" type="text/css">\r
6 </head>\r
7 \r
8 <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">\r
9 <table border=0 width=100%>\r
10 <tr>\r
11 <td><p class=tiny>vorbisfile documentation</p></td>\r
12 <td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>\r
13 </tr>\r
14 </table>\r
15 \r
16 <h1>Seeking</h1>\r
17 <p>Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.\r
18 <p>\r
19 All the <b>vorbisfile</b> seeking routines are declared in "vorbis/vorbisfile.h".\r
20 <p>\r
21 <p>Certain seeking functions are best suited to different situations.  When speed is important, page-level seeking should be used.\r
22 \r
23 </ul>\r
24 \r
25 <table border=1 color=black width=50% cellspacing=0 cellpadding=7>\r
26 <tr bgcolor=#cccccc>\r
27         <td><b>function</b></td>\r
28         <td><b>purpose</b></td>\r
29 </tr>\r
30 <tr valign=top>\r
31         <td><a href="ov_raw_seek.html">ov_raw_seek</a></td>\r
32         <td>This function seeks to a specific byte in the bitstream, specified in bytes.</td>\r
33 </tr>\r
34 <tr valign=top>\r
35         <td><a href="ov_pcm_seek.html">ov_pcm_seek</a></td>\r
36         <td>This function seeks to a specific point in the bitstream, specified in pcm samples.</td>\r
37 </tr>\r
38 <tr valign=top>\r
39         <td><a href="ov_pcm_seek.html">ov_pcm_seek_page</a></td>\r
40         <td>This function seeks to the closest page preceding a point in the bitstream, specified in pcm samples.</td>\r
41 </tr>\r
42 <tr valign=top>\r
43         <td><a href="ov_time_seek.html">ov_time_seek</a></td>\r
44         <td>This function seeks to a time in the bitstream, specified in seconds.  The easiest and simplest seeking method.</td>\r
45 </tr>\r
46 <tr valign=top>\r
47         <td><a href="ov_time_seek_page.html">ov_time_seek_page</a></td>\r
48         <td>This function seeks to the closest page preceding a time in the bitstream, specified in seconds.</td>\r
49 </tr>\r
50 </table>\r
51 \r
52 <br><br>\r
53 <hr noshade>\r
54 <table border=0 width=100%>\r
55 <tr valign=top>\r
56 <td><p class=tiny>copyright &copy; 2000 vorbis team</p></td>\r
57 <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:team@vorbis.org">team@vorbis.org</a></p></td>\r
58 </tr><tr>\r
59 <td><p class=tiny>vorbisfile documentation</p></td>\r
60 <td align=right><p class=tiny>vorbisfile version 1.25 - 20000615</p></td>\r
61 </tr>\r
62 </table>\r
63 \r
64 \r
65 </body>\r
66 \r
67 </html>\r