Mercurial > hg > sv-dependency-builds

annotate src/libvorbis-1.3.3/doc/vorbisfile/seeking.html @ 148:b4bfdf10c4b3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update Win64 capnp builds to v0.6
author Chris Cannam <cannam@all-day-breakfast.com>
date Mon, 22 May 2017 18:56:49 +0100
parents 98c1576536ae
children
rev   line source
cannam@86 1 <html>
cannam@86 2
cannam@86 3 <head>
cannam@86 4 <title>Vorbisfile - Seeking</title>
cannam@86 5 <link rel=stylesheet href="style.css" type="text/css">
cannam@86 6 </head>
cannam@86 7
cannam@86 8 <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
cannam@86 9 <table border=0 width=100%>
cannam@86 10 <tr>
cannam@86 11 <td><p class=tiny>Vorbisfile documentation</p></td>
cannam@86 12 <td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
cannam@86 13 </tr>
cannam@86 14 </table>
cannam@86 15
cannam@86 16 <h1>Seeking</h1>
cannam@86 17 <p>Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.
cannam@86 18 <p>
cannam@86 19 All libvorbisfile seeking routines are declared in "vorbis/vorbisfile.h".
cannam@86 20
cannam@86 21 <p>Certain seeking functions are best suited to different situations.
cannam@86 22 When speed is important and exact positioning isn't required,
cannam@86 23 page-level seeking should be used. Note also that Vorbis files do not
cannam@86 24 necessarily start at a sample number or time offset of zero. Do not
cannam@86 25 be surprised if a file begins at a positive offset of several minutes
cannam@86 26 or hours, such as would happen if a large stream (such as a concert
cannam@86 27 recording) is chopped into multiple separate files. Requesting to
cannam@86 28 seek to a position before the beginning of such a file will seek to
cannam@86 29 the position where audio begins.
cannam@86 30
cannam@86 31 <p>As of vorbisfile version 1.68, seeking also optionally provides
cannam@86 32 automatic crosslapping to eliminate clicks and other discontinuity
cannam@86 33 artifacts at seeking boundaries. This fetaure is of particular
cannam@86 34 interest to player and game developers implementing dynamic music and
cannam@86 35 audio engines, or others looking for smooth transitions within a
cannam@86 36 single sample or across multiple samples.<p>
cannam@86 37
cannam@86 38 <p>Naturally, seeking is available only within a seekable file or
cannam@86 39 stream. Seeking functions will return <tt>OV_ENOSEEK</tt> on
cannam@86 40 nonseekable files and streams.
cannam@86 41
cannam@86 42 </ul>
cannam@86 43
cannam@86 44 <table border=1 color=black width=50% cellspacing=0 cellpadding=7>
cannam@86 45 <tr bgcolor=#cccccc>
cannam@86 46 <td><b>function</b></td>
cannam@86 47 <td><b>purpose</b></td>
cannam@86 48 </tr>
cannam@86 49 <tr valign=top>
cannam@86 50 <td><a href="ov_raw_seek.html">ov_raw_seek</a></td>
cannam@86 51 <td>This function seeks to a position specified in the compressed bitstream, specified in bytes.</td>
cannam@86 52 </tr>
cannam@86 53 <tr valign=top>
cannam@86 54 <td><a href="ov_pcm_seek.html">ov_pcm_seek</a></td>
cannam@86 55 <td>This function seeks to a specific audio sample number, specified in pcm samples.</td>
cannam@86 56 </tr>
cannam@86 57 <tr valign=top>
cannam@86 58 <td><a href="ov_pcm_seek_page.html">ov_pcm_seek_page</a></td>
cannam@86 59 <td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples.</td>
cannam@86 60 </tr>
cannam@86 61 <tr valign=top>
cannam@86 62 <td><a href="ov_time_seek.html">ov_time_seek</a></td>
cannam@86 63 <td>This function seeks to the specific time location in the bitstream, specified in seconds </td>
cannam@86 64 </tr>
cannam@86 65 <tr valign=top>
cannam@86 66 <td><a href="ov_time_seek_page.html">ov_time_seek_page</a></td>
cannam@86 67 <td>This function seeks to the closest page preceding the specified time position in the bitstream</td>
cannam@86 68 </tr>
cannam@86 69
cannam@86 70 </tr>
cannam@86 71 <tr valign=top>
cannam@86 72 <td><a href="ov_raw_seek_lap.html">ov_raw_seek_lap</a></td>
cannam@86 73 <td>This function seeks to a position specified in the compressed bitstream, specified in bytes. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
cannam@86 74 </tr>
cannam@86 75 <tr valign=top>
cannam@86 76 <td><a href="ov_pcm_seek_lap.html">ov_pcm_seek_lap</a></td>
cannam@86 77 <td>This function seeks to a specific audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
cannam@86 78 </tr>
cannam@86 79 <tr valign=top>
cannam@86 80 <td><a href="ov_pcm_seek_page_lap.html">ov_pcm_seek_page_lap</a></td>
cannam@86 81 <td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
cannam@86 82 </tr>
cannam@86 83 <tr valign=top>
cannam@86 84 <td><a href="ov_time_seek_lap.html">ov_time_seek_lap</a></td>
cannam@86 85 <td>This function seeks to the specific time location in the bitstream, specified in seconds. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
cannam@86 86 </tr>
cannam@86 87 <tr valign=top>
cannam@86 88 <td><a href="ov_time_seek_page_lap.html">ov_time_seek_page_lap</a></td>
cannam@86 89 <td>This function seeks to the closest page preceding the specified time position in the bitstream. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
cannam@86 90 </tr>
cannam@86 91 </table>
cannam@86 92
cannam@86 93 <br><br>
cannam@86 94 <hr noshade>
cannam@86 95 <table border=0 width=100%>
cannam@86 96 <tr valign=top>
cannam@86 97 <td><p class=tiny>copyright &copy; 2000-2010 Xiph.Org</p></td>
cannam@86 98 <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
cannam@86 99 </tr><tr>
cannam@86 100 <td><p class=tiny>Vorbisfile documentation</p></td>
cannam@86 101 <td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
cannam@86 102 </tr>
cannam@86 103 </table>
cannam@86 104
cannam@86 105 </body>
cannam@86 106
cannam@86 107 </html>