Chris@1: Chris@1: Chris@1: Chris@1: libvorbisenc - Documentation Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1:

libvorbisenc documentation

libvorbisenc version 1.3.2 - 20101101

Chris@1: Chris@1:

Libvorbisenc API changes 1.0 through 1.1

Chris@1: Chris@1: This document describes API additions to libvorbisenc between release Chris@1: 1.0 and 1.1. Chris@1: Chris@1:

1.0.1

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

1.1

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

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

Chris@1: Chris@1:

Deprecated in 1.1

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

Newly added in 1.1

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

Chris@1: Chris@1:

Chris@1:
OV_ECTL_RATEMANAGE2_GET
Chris@1: Chris@1: Used to query the current state of bitrate management setup. Chris@1: Chris@1:
OV_ECTL_RATEMANAGE2_SET
Chris@1: Chris@1: Used to set or alter bitrate management settings. Chris@1:
Chris@1: Chris@1:

Chris@1:
Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1:

copyright © 2000-2010 Xiph.Org

Ogg Vorbis

libvorbisenc documentation

libvorbisenc version 1.3.2 - 20101101

Chris@1: Chris@1: Chris@1: Chris@1: