Vorbisfile documentation

vorbisfile version 1.3.2 - 20101101

ov_raw_seek_lap

declared in "vorbis/vorbisfile.h";

Seeks to the offset specified (in compressed raw bytes) within the physical bitstream. This variant of ov_raw_seek also automatically crosslaps the transition from the previous playback position into the new playback position in order to eliminate clicking and boundary discontinuities. Otherwise, usage and behavior is identical to ov_raw_seek.

When seek speed is a priority, but crosslapping is still desired, this is the best seek funtion to use.

ov_raw_seek_lap also updates everything needed within the decoder, so you can immediately call ov_read() and get data from the newly seeked to position.

ov_raw_seek_lap will lap between logical stream links of differing numbers of channels. Any extra channels from the origin of the seek are ignored; playback of these channels simply ends. Extra channels at the destination are lapped from silence. ov_raw_seek_lap will also lap between logical stream links of differing sample rates. In this case, the sample rates are ignored (no implicit resampling is done to match playback). It is up to the application developer to decide if this behavior makes any sense in a given context; in practical use, these default behaviors perform sensibly.

This function only works for seekable streams.


int ov_raw_seek_lap(OggVorbis_File *vf,long pos);

Parameters

vf
A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisfile functions.
pos
Position in compressed bytes to seek to in the bitstream.

Return Values




copyright © 2000-2010 Xiph.Org

Ogg Vorbis

Vorbisfile documentation

vorbisfile version 1.3.2 - 20101101