cannam@86:
cannam@86: The ovectl_ratemanage_arg structure is used with vorbis_encode_ctl() and the OV_ECTL_RATEMANAGE_GET,
cannam@86: OV_ECTL_RATEMANAGE_SET, OV_ECTL_RATEMANAGE_AVG,
cannam@86: OV_ECTL_RATEMANAGE_HARD calls in order to query and modify specifics
cannam@86: of the encoder's bitrate management configuration. Note that this is
cannam@86: a deprecated interface; please use vorbis_encode_ctl() with the ovectl_ratemanage2_arg struct
cannam@86: and OV_ECTL_RATEMANAGE2_GET and OV_ECTL_RATEMANAGE2_SET calls in new
cannam@86: code.
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
struct ovectl_ratemanage_arg {
cannam@86: int management_active;
cannam@86:
cannam@86: long bitrate_hard_min;
cannam@86: long bitrate_hard_max;
cannam@86: double bitrate_hard_window;
cannam@86:
cannam@86: long bitrate_av_lo;
cannam@86: long bitrate_av_hi;
cannam@86: double bitrate_av_window;
cannam@86: double bitrate_av_window_center;
cannam@86: };
cannam@86:
cannam@86:
cannam@86:
cannam@86:
cannam@86:
Relevant Struct Members
cannam@86:
cannam@86:
cannam@86:
management_active
cannam@86:
nonzero if bitrate management is active
cannam@86:
cannam@86:
bitrate_hard_min
cannam@86:
hard lower limit (in kilobits per second) below which the stream bitrate will never be allowed for any given bitrate_hard_window seconds of time.
cannam@86:
bitrate_hard_max
cannam@86:
hard upper limit (in kilobits per second) above which the stream bitrate will never be allowed for any given bitrate_hard_window seconds of time.
cannam@86:
bitrate_hard_window
cannam@86:
the window period (in seconds) used to regulate the hard bitrate minimum and maximum
cannam@86:
cannam@86:
bitrate_av_lo
cannam@86:
soft lower limit (in kilobits per second) below which the average bitrate tracker will start nudging the bitrate higher.
cannam@86:
bitrate_av_hi
cannam@86:
soft upper limit (in kilobits per second) above which the average bitrate tracker will start nudging the bitrate lower.
cannam@86:
bitrate_av_window
cannam@86:
the window period (in seconds) used to regulate the average bitrate minimum and maximum.
cannam@86:
bitrate_av_window_center
cannam@86:
Regulates the relative centering of the average and hard windows; in libvorbis 1.0 and 1.0.1, the hard window regulation overlapped but followed the average window regulation. In libvorbis 1.1 a bit-reservoir interface replaces the old windowing interface; the older windowing interface is simulated and this field has no effect.