Tremor - Vorbisfile Differences

Tremor documentation | Tremor version 1.0 - 20020403

# Tremor / Vorbisfile API Differences

The Tremor libvorbisidec library exposes an API intended to be as similar as possible to the familiar 'vorbisfile' library included with the open source Vorbis reference libraries distributed for free by Xiph.org. Differences are summarized below.

## OggVorbis_File structure

The `bittrack` and `samptrack` fields in the OggVorbis_File structure are changed to 64 bit integers in Tremor, from doubles in vorbisfile.

## Time-related seek and tell function calls

The ov_time_total() and ov_time_tell() functions return milliseconds as 64 bit integers in Tremor. In vorbisfile, these functions returned seconds as doubles.

In Tremor, the ov_time_seek() and ov_time_seek_page() calls take seeking positions in milliseconds as 64 bit integers, rather than in seconds as doubles as in Vorbisfile.

## Reading decoded data

Tremor ov_read() always returns data as signed 16 bit interleaved PCM in host byte order. As such, it does not take arguments to request specific signedness, byte order or bit depth as in Vorbisfile.

Tremor does not implement `ov_read_float()`.

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