Enum SimpleRateControlMode 

pub enum SimpleRateControlMode {
    ConstantQuality {
        crf: u8,
    },
    AverageBitrate {
        target_kbps: u32,
    },
    ConstantBitrate {
        target_kbps: u32,
        vbv_size_kb: u32,
    },
    VariableBitrate {
        min_kbps: u32,
        max_kbps: u32,
        target_kbps: u32,
    },
    TwoPass {
        target_kbps: u32,
        first_pass_stats: Option<String>,
    },
}

Simplified rate control mode for video encoding.

Each variant carries all parameters needed to drive the corresponding algorithm without requiring a separate configuration struct.

Variants

ConstantQuality

Constant-quality mode (CRF / CQ).

The crf value (0–63, lower = higher quality) drives a QP calculation. Bitrate is not constrained; it grows with content complexity.

Fields

crf: u8

Constant Rate Factor (0–63).

AverageBitrate

Average-bitrate mode (ABR).

The encoder targets target_kbps averaged over the whole clip. Individual frames may deviate based on content complexity.

Fields

target_kbps: u32

Target average bitrate in kbps.

ConstantBitrate

Constant-bitrate mode (CBR) with a VBV (Video Buffer Verifier) buffer.

Per-frame bits are clamped so that the VBV never overflows (fullness > 0.9) or starves (fullness < 0.3).

Fields

target_kbps: u32

Target constant bitrate in kbps.

vbv_size_kb: u32

VBV buffer size in kilobits.

VariableBitrate

Variable-bitrate mode (VBR).

Like ABR but the instantaneous bitrate is clamped to [min_kbps, max_kbps].

Fields

min_kbps: u32

Minimum instantaneous bitrate in kbps.

max_kbps: u32

Maximum instantaneous bitrate in kbps.

target_kbps: u32

Long-term average target in kbps.

TwoPass

Two-pass average-bitrate mode.

On the second pass, bits are allocated proportional to the per-frame complexity ratios recorded during the first pass. first_pass_stats is a newline-separated string of f32 complexity values, one per frame (e.g. produced by SimpleRateController::record_frame).

Fields

target_kbps: u32

Target average bitrate in kbps.

first_pass_stats: Option<String>

Serialised first-pass complexity data (one f32 per line).

Trait Implementations

impl Clone for SimpleRateControlMode

fn clone(&self) -> SimpleRateControlMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SimpleRateControlMode

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

Formats the value using the given formatter.