File Information

Libvorbisfile contains many functions to get information about bitstream attributes and decoding status.
Libvorbisfileはビットストリームの属性やデコードに関する情報を所得するたくさんの関数を含んでいる。

All libvorbisfile file information routines are declared in "vorbis/vorbisfile.h".
libvorbisのファイル情報ルーティンはすべて"vorbis/vorbisfile.h"に定義されている。

function	purpose
ov_bitrate	Returns the average bitrate of the current logical bitstream. 現在の論理ビットストリームの平均ビットレートを返す
ov_bitrate_instant	Returns the exact bitrate since the last call of this function, or -1 if at the beginning of the bitream or no new information is available. 最後にこの関数を呼んだ位置からの実際のビットレートを返す。ビットストリームの最初か、新しい有効な情報がないとき-1を返す。
ov_streams	Gives the number of logical bitstreams within the current physical bitstream. 現在の物理ビットストリームに存在する論理ビットストリームの数を返す。
ov_seekable	Indicates whether the bitstream is seekable. ビットストリームが移動可能かを返す。
ov_serialnumber	Returns the unique serial number of the specified logical bitstream. 特定の論理ビットストリームの固有シリアルナンバーを返す。
ov_raw_total	Returns the total (compressed) bytes in a physical or logical seekable bitstream. 物理/移動可能な論理ビットストリームの圧縮済みの合計のバイト数を返す。
ov_pcm_total	Returns the total number of samples in a physical or logical seekable bitstream. 物理/移動可能な論理ビットストリームの合計のサンプル数を返す。
ov_time_total	Returns the total time length in seconds of a physical or logical seekable bitstream. 物理/移動可能な論理ビットストリームの合計の時間を秒で返す。
ov_raw_tell	Returns the byte location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached. デコードエンジンが到達しているストリーム内での大体の位置が示す、 次に読むサンプルの位置をバイト単位で返す。
ov_pcm_tell	Returns the sample location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached. デコードエンジンが到達しているストリーム内での大体の位置が示す、 次に読むサンプルの位置をサンプル番号で返す。
ov_time_tell	Returns the time location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached. デコードエンジンが到達しているストリーム内での大体の位置が示す、 次に読むサンプルの位置を時間で返す。
ov_info	Returns the vorbis_info struct for a specific bitstream section. 特定のビットストリームセクションの vorbis_info 構造体を返す。
ov_comment	Returns attached comments for the current bitstream. 現在のビットストリームに付属している comments を返す。