Software: Apache/2.0.54 (Fedora). PHP/5.0.4 

uname -a: Linux mina-info.me 2.6.17-1.2142_FC4smp #1 SMP Tue Jul 11 22:57:02 EDT 2006 i686 

uid=48(apache) gid=48(apache) groups=48(apache)
context=system_u:system_r:httpd_sys_script_t 

Safe-mode: OFF (not secure)

/usr/share/doc/libvorbis-devel-1.1.0/vorbisfile/   drwxr-xr-x
Free 3.76 GB of 27.03 GB (13.9%)
                            Encoder    Tools    Proc.    FTP brute    Sec.    SQL    PHP-code    Update    Feedback    Self remove    Logout    

Viewing file:     ov_read_float.html (2.8 KB)      -rw-r--r--

ov_read_float()

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 more information on 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);

Parameters

vf

A pointer to the OggVorbis_File structure--this is used for ALL the externally visible vorbisfile functions.

pcm_channels

A pointer to an output buffer. The pointer will be set to the decoded output buffer.

samples

Maximum number of decoded samples to produce.

bitstream

bitstream

A pointer to the number of the current logical bitstream.

Return Values

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.

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.

Notes

Typical usage:

float **pcm; samples_read = ov_read_float(&vf,pcm, 1024, &current_section)