Struct AudioFrameGrid 

pub struct AudioFrameGrid {
    pub anchor: i64,
    pub period: i64,
    pub start_tolerance: i64,
    pub trimmed_tolerance: i64,
}

Frame start samples of an audio stream, every period samples from anchor, inferred from its first packet timestamps (audio_frame_grid).

Containers that round timestamps (Matroska and WebM to the millisecond) place a frame up to half a unit (24 samples at 48 kHz) off its true start, and a seek and a straight decode are off by different amounts. For fixed-length frames (AAC’s 1024 samples, Opus’s 20 ms) the first timestamps together locate the grid far more precisely, so snapping to it makes a seek give the same samples as a straight decode.

Fields

anchor: i64

A source sample at which a frame starts.

period: i64

Samples per frame.

start_tolerance: i64

Farthest a frame timestamp, in samples, can be from its true start: half the rounding unit plus half a sample, rounded.

trimmed_tolerance: i64

Farthest the end of a trimmed frame (shorter than period, as after Opus pre-skip) can be from the grid. The trim is rounded again, so this is a full unit plus a sample.

Implementations

impl AudioFrameGrid

pub fn place(&self, at: i64, frames: i64) -> i64

Start of a frames-sample frame whose timestamp says at: snapped to the grid when within tolerance, otherwise at.

A frame shorter than Self::period is first tried as a trimmed frame ending on the grid.

Trait Implementations

impl Clone for AudioFrameGrid

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AudioFrameGrid

impl Debug for AudioFrameGrid

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

Formats the value using the given formatter.

impl Eq for AudioFrameGrid

impl PartialEq for AudioFrameGrid

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AudioFrameGrid