cannam@86: cannam@86: cannam@86: cannam@86: libvorbisenc - Documentation cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:

libvorbisenc documentation

libvorbisenc version 1.3.2 - 20101101

cannam@86: cannam@86:

Libvorbisenc API changes 1.0 through 1.1

cannam@86: cannam@86: This document describes API additions to libvorbisenc between release cannam@86: 1.0 and 1.1. cannam@86: cannam@86:

1.0.1

cannam@86: cannam@86: The programming API and binary application ABI are unchanged and fully cannam@86: forward/backward compatible between release 1.0 and 1.0.1. Libvorbis, cannam@86: libvorbisenc and libvorbisfile must match versions amongst themselves, cannam@86: however. cannam@86: cannam@86:

1.1

cannam@86: cannam@86: The binary ABI from release 1.0.1 to 1.1 is backward compatible; cannam@86: applications linked against libvorbis/libvorbisenc 1.0 and 1.0.1 will cannam@86: continue to function correctly when upgrading the libvorbis and cannam@86: libvorbisenc dynamic libraries without re-linking.

cannam@86: cannam@86: Release 1.1 adds several possible requests to the libvorbisenc vorbis_encode_ctl() call in order to cannam@86: reflect the shift to bit-reservoir style cannam@86: bitrate management. In addition, several vorbis_encode_ctl() requests are cannam@86: deprecated (but functional) as they are redered semantically obsolete cannam@86: by the new bitrate management.

cannam@86: cannam@86:

Deprecated in 1.1

cannam@86: cannam@86: These calls are still available to older codebases to preserve cannam@86: compatability; the fields of the ovectl_ratemanage_arg argument cannam@86: are mapped as closely as possible to the fields of the new ovectl_ratemanage2_arg cannam@86: structure. cannam@86: cannam@86:
cannam@86:
OV_ECTL_RATEMANAGE_GET:
Use OV_ECTL_RATEMANAGE2_GET cannam@86: instead. cannam@86: cannam@86: cannam@86:
OV_ECTL_RATEMANAGE_SET:
Use OV_ECTL_RATEMANAGE2_SET cannam@86: instead. cannam@86: cannam@86:
OV_ECTL_RATEMANAGE_AVG:
Use OV_ECTL_RATEMANAGE2_SET cannam@86: instead. cannam@86: cannam@86:
OV_ECTL_RATEMANAGE_HARD:
Use OV_ECTL_RATEMANAGE2_SET cannam@86: instead. cannam@86:
cannam@86: cannam@86:

Newly added in 1.1

cannam@86: cannam@86: The following calls are added in 1.1 to semantically reflect movement cannam@86: to a bit-reservoir-based bitrate cannam@86: management scheme by introducing the ovectl_ratemanage2_arg cannam@86: structure in order to better represent the abilities of the bitrate cannam@86: manager.

cannam@86: cannam@86:

cannam@86:
OV_ECTL_RATEMANAGE2_GET
cannam@86: cannam@86: Used to query the current state of bitrate management setup. cannam@86: cannam@86:
OV_ECTL_RATEMANAGE2_SET
cannam@86: cannam@86: Used to set or alter bitrate management settings. 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

libvorbisenc documentation

libvorbisenc version 1.3.2 - 20101101

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