Vorbisfile documentation |
vorbisfile version 1.3.2 - 20101101 |
declared in "vorbis/vorbisfile.h";
This is the function used to decode a Vorbis file within a loop, but returns samples in native float format instead of in integer formats.
For information on channel ordering and how ov_read_float() deals with the complex issues of chaining, etc, refer to the documentation for ov_read().
long ov_read_float(OggVorbis_File *vf, float ***pcm_channels, int samples, int *bitstream); |
- OV_HOLE
- indicates there was an interruption in the data.
(one of: garbage between pages, loss of sync followed by recapture, or a corrupt page)- OV_EBADLINK
- indicates that an invalid stream section was supplied to libvorbisfile, or the requested link is corrupt.
- OV_EINVAL
- indicates the initial file headers couldn't be read or are corrupt, or that the initial open call for vf failed.
- 0
- indicates EOF
- n
- indicates actual number of samples read. ov_read_float() will decode at most one vorbis packet per invocation, so the value returned will generally be less than length.
Typical usage:
float **pcm; samples_read = ov_read_float(&vf,pcm, 1024, ¤t_section)This decodes up to 1024 float samples.
copyright © 2002 vorbis team |
|
Vorbisfile documentation |
vorbisfile version 1.3.2 - 20101101 |