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.
これはループ内でVorbisファイルをデコードするのに使う関数であるが、 整数の代わりにネイティブの浮動少数(float)でサンプルデータを返す。

For more information on how ov_read_float() deals with the complex issues of chaining, etc, refer to the documentation for ov_read().
ov_read_float() に関するほかの情報、結合に関する複雑な問題の扱い方など、は ov_read() のドキュメントを参照せよ。

long ov_read(OggVorbis_File *vf, float ***pcm_channels, int *bitstream);

Parameters

vf

A pointer to the OggVorbis_File structure--this is used for ALL the externally visible vorbisfile functions.
OggVorbis_File構造体へのポインタ。 これはすべての対外的に可視であるlibvorbisfileの関数で使用される。

pcm_channels

A pointer to an output buffer. The pointer will be set to the decoded output buffer.
出力バッファへのポインタ。ポインタはデコード済みデータの出力バッファにセットされるだろう。

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.
無効なストリームセクションがlibvorbisfileに提供されたか、要求されたリンクが間違っていることを示す。

0

indicates EOF　 EOFを示す

n

indicates actual number of bytes read. ov_read() will decode at most one vorbis packet per invocation, so the value returned will generally be less than length.
実際に読み込んだバイト数を示す。ov_read()は呼出しごとに 最大で１つのVorbisパケットしかデコードしないため、 返ってくる値は通常 length より小さい。
*訳注: ov_read() のものをコピー＆ペーストしたための間違いと思われる。 この関数に length は無いし、関数名も ov_read_float() である。

Notes

Typical usage:

float **pcm; bytes_read = ov_read_float(&vf,pcm,&current_section)
*訳注: float **pcm; bytes_read = ov_read_float(&vf,&pcm,&current_section) だと思われる。