Struct Segment 

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

A fully-built Matroska segment. This is where actual video/audio frames are written.

This is created via SegmentBuilder. Once built in this way, the list of tracks and their parameters become immutable.

Finalization

Once you are done writing frames to this segment, you must call Segment::finalize on it. This performs a few final writes, and the resulting WebM may not be playable without it. Notably, for memory safety reasons, just dropping a Segment will not finalize it!

Implementations

impl<W: Write> Segment<W>

pub fn add_frame( &mut self, track: impl Into<TrackNum>, data: &[u8], timestamp_ns: u64, keyframe: bool, ) -> Result<(), Error>

Adds a frame to the track with the specified track number. If you have a VideoTrack or AudioTrack, you can either pass it directly, or call track_number() to get the underlying TrackNum.

The timestamp must be in nanosecond units, and must be monotonically increasing with respect to all other timestamps written so far, including those of other tracks! Repeating the last written timestamp is allowed, however players generally don’t handle this well if both such frames are on the same track.

pub fn finalize(self, duration: Option<u64>) -> Result<Writer<W>, Writer<W>>

Finalizes the segment and consumes it, returning the underlying writer. Note that the finalizing process will itself trigger writes (such as to write seeking information).

The resulting WebM may not be playable if you drop the Segment without calling this first!

You may specify an explicit duration to be written to the segment’s Duration element. However, this requires seeking and thus will be ignored if the writer was not created with Seek support.

Finalization is known to fail if no frames have been written.

Trait Implementations

impl<W: Write> Debug for Segment<W>

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

Formats the value using the given formatter.