Vorbisfile documentation |
cannam@86: vorbisfile version 1.3.2 - 20101101 |
cannam@86:
declared in "vorbis/vorbisfile.h";
cannam@86: cannam@86:Seeks to the offset specified (in compressed raw bytes) within the cannam@86: physical bitstream. This variant of ov_raw_seek also automatically crosslaps cannam@86: the transition from the previous playback position into the new cannam@86: playback position in order to eliminate clicking and boundary cannam@86: discontinuities. Otherwise, usage and behavior is identical to ov_raw_seek. cannam@86: cannam@86:
When seek speed is a priority, but crosslapping is still desired, cannam@86: this is the best seek funtion to use. cannam@86: cannam@86:
ov_raw_seek_lap also updates everything needed within the decoder, cannam@86: so you can immediately call ov_read() and cannam@86: get data from the newly seeked to position. cannam@86: cannam@86:
ov_raw_seek_lap will lap between logical stream links of differing cannam@86: numbers of channels. Any extra channels from the origin of the seek cannam@86: are ignored; playback of these channels simply ends. Extra channels at cannam@86: the destination are lapped from silence. ov_raw_seek_lap will also cannam@86: lap between logical stream links of differing sample rates. In this cannam@86: case, the sample rates are ignored (no implicit resampling is done to cannam@86: match playback). It is up to the application developer to decide if cannam@86: this behavior makes any sense in a given context; in practical use, cannam@86: these default behaviors perform sensibly. cannam@86: cannam@86:
This function only works for seekable streams.
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86: cannam@86: int ov_raw_seek_lap(OggVorbis_File *vf,long pos); cannam@86:cannam@86: |
cannam@86:
cannam@86:cannam@86: cannam@86:cannam@86:
- 0 for success
cannam@86: cannam@86:- cannam@86: nonzero indicates failure, described by several error codes: cannam@86:
cannam@86:cannam@86:
- OV_ENOSEEK - Bitstream is not seekable. cannam@86:
cannam@86:- OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open. cannam@86:
cannam@86:- OV_EREAD - A read from media returned an error. cannam@86:
cannam@86:- OV_EFAULT - Internal logic fault; indicates a bug or heap/stack cannam@86: corruption. cannam@86:
cannam@86:- OV_EOF - Indicates stream is at end of file immediately after a seek cannam@86: (making crosslap impossible as there's no preceeding decode state to crosslap). cannam@86:
cannam@86:- OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt. cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
copyright © 2000-2010 Xiph.Org |
cannam@86: cannam@86: |
Vorbisfile documentation |
cannam@86: vorbisfile version 1.3.2 - 20101101 |
cannam@86: