Enum OggVorbisBitrateStrategy

pub enum OggVorbisBitrateStrategy {
    Vbr(u32),
    QualityVbr(f32),
    Abr(u32),
    ConstrainedAbr(u32),
}

• OggVorbis bitrate strategy represents a bitrate management strategy that a OggVorbis encoder can use.

Variants

Vbr(u32)

• Pure VBR quality mode, selected by a target bitrate (in bit/s).
• The bitrate management engine is not enabled.
• The average bitrate will usually be close to the target, but there are no guarantees.
• Easier or harder than expected to encode audio may be encoded at a significantly different bitrate.

QualityVbr(f32)

• Similar to Vbr, this encoding strategy fixes the output subjective quality level,
• but lets OggVorbis vary the target bitrate depending on the qualities of the input signal.
• An upside of this approach is that OggVorbis can automatically increase or decrease the target bitrate according to how difficult the signal is to encode,
• which guarantees perceptually-consistent results while using an optimal bitrate.
• Another upside is that there always is some mode to encode audio at a given quality level.
• The downside is that the output bitrate is harder to predict across different types of audio signals.

Abr(u32)

• ABR mode, selected by an average bitrate (in bit/s).
• The bitrate management engine is enabled to ensure that the instantaneous bitrate does not divert significantly from the specified average over time,
• but no hard bitrate limits are imposed. Any bitrate fluctuations are guaranteed to be minor and short.

ConstrainedAbr(u32)

• Constrained ABR mode, selected by a hard maximum bitrate (in bit/s).
• The bitrate management engine is enabled to ensure that the instantaneous bitrate never exceeds the specified maximum bitrate,
• which is a hard limit. Internally, the encoder will target an average bitrate that s slightly lower than the specified maximum bitrate.
• The stream is guaranteed to never go above the specified bitrate, at the cost of a lower bitrate,
• and thus lower audio quality, on average.

Trait Implementations

impl Clone for OggVorbisBitrateStrategy

fn clone(&self) -> OggVorbisBitrateStrategy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OggVorbisBitrateStrategy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OggVorbisBitrateStrategy

fn default() -> Self

Returns the “default value” for a type.

impl From<OggVorbisBitrateStrategy> for VorbisBitrateManagementStrategy

fn from(val: OggVorbisBitrateStrategy) -> Self

• Convert to the VorbisBitrateManagementStrategy from vorbis_rs crate

impl From<VorbisBitrateManagementStrategy> for OggVorbisBitrateStrategy

fn from(vbms: VorbisBitrateManagementStrategy) -> Self

• Convert from VorbisBitrateManagementStrategy from vorbis_rs crate

impl PartialEq for OggVorbisBitrateStrategy

fn eq(&self, other: &OggVorbisBitrateStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for OggVorbisBitrateStrategy

impl StructuralPartialEq for OggVorbisBitrateStrategy