Struct FragmentWriter 

pub struct FragmentWriter<W: Write> { /* private fields */ }

Codec-agnostic fMP4 fragment writer: ftyp+moov once, then one moof+mdat pair per video sample, each anchored at its wall-clock decode time via tfdt, and one per batch of audio samples.

Implementations

impl<W: Write> FragmentWriter<W>

pub fn new(out: W) -> Self

pub fn with_audio(self, cfg: AudioTrackConfig) -> Self

Declare the audio track; must precede write_init.

pub fn init_written(&self) -> bool

pub fn stats(&self) -> Mp4Stats

Counters for the fragments written so far (the buffered pending sample is not yet included; finish folds it in).

pub fn write_init(&mut self, cfg: &TrackConfig) -> Result<()>

Write ftyp + moov (the video track, the audio track when declared, and the mvex/trex marking the movie fragmented). Must be called once, before the first sample.

pub fn push_sample( &mut self, data: Vec<u8>, sync: bool, pts_us: u64, ) -> Result<()>

Queue one sample at pts_us (wall-clock microseconds since recording start), flushing the previously buffered sample with its now-known duration. Timestamps are clamped strictly monotonic so a repeated or reordered clock can never emit a zero/negative duration.

pub fn push_audio(&mut self, data: Vec<u8>, dts: u64) -> Result<()>

Queue one audio packet decoding at dts on the 48 kHz clock. A packet that does not follow the pending ones directly (a gap in the stream) closes their fragment first, so every fragment’s samples are contiguous from its tfdt.

pub fn finish(self) -> Result<Mp4Stats>

Flush the pending audio and the final buffered video sample, closed with the MEDIAN observed inter-frame duration (its successor never arrives), and return the aggregate counters.