Tremor documentation | Tremor version 1.0 - 20020403

# Seeking

Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.

All libvorbisidec seeking routines are declared in "ivorbisfile.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.

function | purpose
ov_raw_seek | This function seeks to a position specified in the compressed bitstream, specified in bytes.
ov_pcm_seek | This function seeks to a specific audio sample number, specified in pcm samples.
ov_pcm_seek_page | This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples.
ov_time_seek | This function seeks to the specific time location in the bitstream, specified in integer milliseconds. Note that this differs from the reference vorbisfile implementation, which takes seconds as a float.
ov_time_seek_page | This function seeks to the closest page preceding the specified time position in the bitstream, specified in integer milliseconds.

copyright © 2002 Xiph.org | Ogg Vorbis
Tremor documentation | Tremor version 1.0 - 20020403