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