Struct PeakOffset 

pub struct PeakOffset {
    per_frame: f64,
    buffer: f64,
    pub(crate) fill: f64,
    pub(crate) offset: f64,
}

The peak of a capped constant quality held beside an encoder that codes its constant quality per frame and has no rate control to bind to it (x264, SVT-AV1), where PeakBucket switches one that does. A leaky bucket of the peak, its buffer the session’s VBV, takes each frame: from a frame that overflows it the quality index stands offset steps above the session’s, aimed after each frame at bringing the bucket back to half full in DRAIN_FRAMES frames (a size halving every six steps) and lowered at most RELEASE_STEP a frame, so a session that never overflows it codes as an uncapped one.

Fields

per_frame: f64

Bits a frame drains from the bucket, and the bucket’s buffer.

buffer: f64

fill: f64

offset: f64

Quality index steps above the session’s own.

Implementations

impl PeakOffset

const DRAIN_FRAMES: f64 = 8.0

const RELEASE_STEP: f64 = 2.0

pub fn new(bitrate_kbps: i32, vbv_kbit: i32, fps: f64) -> Self

pub fn follow(&mut self, bitrate_kbps: i32, vbv_kbit: i32, fps: f64)

Take a live peak and buffer.

pub fn note(&mut self, bits: f64, steers: bool, max_offset: f64) -> f64

Fold in a frame of bits and return the offset the next frame takes. A key frame, or a frame held at a quantizer of its own (steers false), fills the bucket but says nothing of what the session’s own frames come to.

pub fn room(&self) -> f64

The bits the next frame has before the bucket overflows.

Trait Implementations

impl Clone for PeakOffset

fn clone(&self) -> PeakOffset

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PeakOffset

impl Debug for PeakOffset

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

Formats the value using the given formatter.