Whole document tree

ov_time_total

declared in "vorbis/vorbisfile.h";

Returns the total time in seconds of the physical bitstream or a specified logical bitstream.

double ov_time_total(OggVorbis_File *vf,int i);

Parameters

vf

A pointer to the OggVorbis_File structure--this is used for ALL the externally visible vorbisfile functions. Once this has been called, the same OggVorbis_File struct should be passed to all the vorbisfile functions.

i

Link to the desired logical bitstream. To retrieve the vorbis_info struct for the current bitstream, this parameter should be set to -1.

Return Values

OV_EINVAL means that the argument was invalid. In this case, the requested bitstream did not exist or the bitstream is nonseekable.

total length in seconds of content if i=-1.

length in seconds of logical bitstream if i=1 to n.

Notes

Typical usage: bytes_read = ov_read(&vf, buffer, 4096,0,2,1,&current_section)
This reads up to 4096 bytes into a buffer, with signed 16-bit little-endian samples.