libvorbisenc documentation | libvorbisenc version 1.3.2 - 20101101

# ovectl_ratemanage_arg

declared in "vorbis/vorbisenc.h"

The ovectl_ratemanage_arg structure is used with vorbis_encode_ctl() and the OV_ECTL_RATEMANAGE_GET, OV_ECTL_RATEMANAGE_SET, OV_ECTL_RATEMANAGE_AVG, OV_ECTL_RATEMANAGE_HARD calls in order to query and modify specifics of the encoder's bitrate management configuration. Note that this is a deprecated interface; please use vorbis_encode_ctl() with the ovectl_ratemanage2_arg struct and OV_ECTL_RATEMANAGE2_GET and OV_ECTL_RATEMANAGE2_SET calls in new code.

    struct ovectl_ratemanage_arg {
      int    management_active;

      long   bitrate_hard_min;
      long   bitrate_hard_max;
      double bitrate_hard_window;

      long   bitrate_av_lo;
      long   bitrate_av_hi;
      double bitrate_av_window;
      double bitrate_av_window_center;
    };

### Relevant Struct Members

management_active
  nonzero if bitrate management is active
bitrate_hard_min
  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.
bitrate_hard_max
  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.
bitrate_hard_window
  the window period (in seconds) used to regulate the hard bitrate minimum and maximum
bitrate_av_lo
  soft lower limit (in kilobits per second) below which the average bitrate tracker will start nudging the bitrate higher.
bitrate_av_hi
  soft upper limit (in kilobits per second) above which the average bitrate tracker will start nudging the bitrate lower.
bitrate_av_window
  the window period (in seconds) used to regulate the average bitrate minimum and maximum.
bitrate_av_window_center
  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.

copyright © 2000-2010 Xiph.Org | Ogg Vorbis
libvorbisenc documentation | libvorbisenc version 1.3.2 - 20101101