Vorbisfile documentation |
vorbisfile version 1.68 - 20030307 |
Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.
All libvorbisfile seeking routines are declared in "vorbis/vorbisfile.h".
Certain seeking functions are best suited to different situations. When speed is important and exact positioning isn't required, page-level seeking should be used. Note also that Vorbis files do not necessarily start at a sample number or time offset of zero. Do not be surprised if a file begins at a positive offset of several minutes or hours, such as would happen if a large stream (such as a concert recording) is chopped into multiple separate files. Requesting to seek to a position before the beginning of such a file will seek to the position where audio begins.
As of vorbisfile version 1.68, seeking also optionally provides automatic crosslapping to eliminate clicks and other discontinuity artifacts at seeking boundaries. This fetaure is of particular interest to player and game developers implementing dynamic music and audio engines, or others looking for smooth transitions within a single sample or across multiple samples.
Naturally, seeking is available only within a seekable file or stream. Seeking functions will return OV_ENOSEEK on nonseekable files and streams.
| function | purpose | |
| ov_raw_seek | This function seeks to a position specified in the compressed bitstream, specified in bytes.,ght © 2004 Xiph.org | |
Vorbisfile documentation |
vorbisfile version 1.68 - 20030307 |