cannam@86: cannam@86: cannam@86: cannam@86: Vorbisfile - function - ov_bitrate cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:

Vorbisfile documentation

vorbisfile version 1.3.2 - 20101101

cannam@86: cannam@86:

ov_bitrate

cannam@86: cannam@86:

declared in "vorbis/vorbisfile.h";

cannam@86: cannam@86:

This function returns the average bitrate for the specified logical bitstream. This may be different from the ov_info->nominal_bitrate value, as it is based on the actual average for this bitstream if the file is seekable. cannam@86:

Nonseekable files will return the nominal bitrate setting or the average of the upper and lower bounds, if any of these values are set. cannam@86:

cannam@86: cannam@86:

cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:
cannam@86: 

cannam@86: long ov_bitrate(OggVorbis_File *vf,int i);
cannam@86:
cannam@86:
cannam@86: cannam@86:

Parameters

cannam@86:
cannam@86:
vf
cannam@86:
A pointer to the OggVorbis_File structure--this is used for ALL the externally visible libvorbisfile cannam@86: functions.
cannam@86:
i
cannam@86:
Link to the desired logical bitstream. For nonseekable files, this argument is ignored. To retrieve the bitrate for the entire bitstream, this parameter should be set to -1.
cannam@86:
cannam@86: cannam@86: cannam@86:

Return Values

cannam@86:
cannam@86:
  • OV_EINVAL indicates that an invalid argument value was submitted or that the stream represented by vf is not open.
    • cannam@86:
  • OV_FALSE means the call returned a 'false' status, which in this case most likely indicates that the file is nonseekable and the upper, lower, and nominal bitrates were unset. cannam@86:
  • n indicates the bitrate for the given logical bitstream or the entire cannam@86: physical bitstream. If the file is open for random (seekable) access, it will cannam@86: find the *actual* average bitrate. If the file is streaming (nonseekable), it cannam@86: returns the nominal bitrate (if set) or else the average of the cannam@86: upper/lower bounds (if set).
    • cannam@86:
    cannam@86:

    cannam@86: cannam@86: cannam@86:

    cannam@86:

    cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:

    copyright © 2000-2010 Xiph.Org

    Ogg Vorbis

    Vorbisfile documentation

    vorbisfile version 1.3.2 - 20101101

    cannam@86: cannam@86: cannam@86: cannam@86: