From 74f4b1bc3b627ba4c7e03498234d88cacdfbe97b Mon Sep 17 00:00:00 2001 From: Aki Date: Wed, 29 Sep 2021 22:52:49 +0200 Subject: Squashed 'vorbis/' content from commit d22c3ab5f git-subtree-dir: vorbis git-subtree-split: d22c3ab5f633460abc2532feee60ca0892134cbf --- doc/vorbisfile/ov_time_seek_page_lap.html | 112 ++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 doc/vorbisfile/ov_time_seek_page_lap.html (limited to 'doc/vorbisfile/ov_time_seek_page_lap.html') diff --git a/doc/vorbisfile/ov_time_seek_page_lap.html b/doc/vorbisfile/ov_time_seek_page_lap.html new file mode 100644 index 0000000..3b1effa --- /dev/null +++ b/doc/vorbisfile/ov_time_seek_page_lap.html @@ -0,0 +1,112 @@ + + + +Vorbisfile - function - ov_time_seek_page_lap + + + + + + + + + +

Vorbisfile documentation

vorbisfile version 1.3.2 - 20101101

+ +

ov_time_seek_page_lap

+ +

declared in "vorbis/vorbisfile.h";

+ +

For seekable streams, ov_time_seek_page_lap seeks to the closest +full page preceeding the given time. This variant of ov_time_seek_page 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_time_seek_page. + +

ov_time_seek_page_lap is faster than ov_time_seek_lap because it doesn't +seek through the last few samples to reach an exact time, but it is +also less accurate. This should be used when speed is important, but +crosslapping is still desired. + +

ov_time_seek_page_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_time_seek_page_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_time_seek_page_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 does not work for unseekable streams. + +

+ + + + +
+
+int ov_time_seek_page_lap(OggVorbis_File *vf, double s); +
+
+ +

Parameters

vf: Pointer to our already opened and initialized OggVorbis_File structure.
pos: Location to seek to within the file, specified in seconds.

+ + +

Return Values

+
+
0 for success
+ +
+nonzero indicates failure, described by several error codes: +
+
OV_ENOSEEK - Bitstream is not seekable. +
+
OV_EINVAL - Invalid argument value; possibly called with an OggVorbis_File structure that isn't open. +
+
OV_EREAD - A read from media returned an error. +
+
OV_EFAULT - Internal logic fault; indicates a bug or heap/stack + corruption. +
+
OV_EOF - Indicates stream is at end of file immediately after a seek + (making crosslap impossible as there's no preceeding decode state to crosslap). +
+
OV_EBADLINK - Invalid stream section supplied to libvorbisfile, or the requested link is corrupt. +
+
+

+ + +

+

+ + + + + + + + +

copyright © 2000-2010 Xiph.Org	Ogg Vorbis
Vorbisfile documentation	vorbisfile version 1.3.2 - 20101101

+ + + + -- cgit v1.1