Struct CodecConfigTracker 

pub struct CodecConfigTracker { /* private fields */ }

Tracks H.264 and H.265 parameter sets across access units.

Implementations

impl CodecConfigTracker

pub fn inspect( &mut self, codec: VideoCodec, data: &[u8], ) -> Result<(ConfigUpdate, bool), VideoError>

Inspect one access unit for both parameter-set changes and keyframes.

Decoder backends should prefer this method over calling Self::observe and Self::is_keyframe separately because it scans Annex-B only once.

pub fn observe( &mut self, codec: VideoCodec, data: &[u8], ) -> Result<ConfigUpdate, VideoError>

Inspect an Annex-B access unit and update cached parameter sets.

Examples found in repository

examples/inspect_annex_b.rs (line 18)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut args = env::args().skip(1);
    let codec = match args.next().as_deref() {
        Some("h264") => VideoCodec::H264,
        Some("h265") | Some("hevc") => VideoCodec::H265,
        _ => return Err("usage: inspect_annex_b <h264|h265> <access-unit-file>".into()),
    };
    let path = args
        .next()
        .ok_or("usage: inspect_annex_b <h264|h265> <access-unit-file>")?;
    let data = fs::read(path)?;
    let units = annex_b::nal_units(&data)?;
    let mut tracker = CodecConfigTracker::default();
    let config = tracker.observe(codec, &data)?;

    println!(
        "codec={codec} bytes={} nal_units={}",
        data.len(),
        units.len()
    );
    println!(
        "configuration={}",
        match config {
            ConfigUpdate::Incomplete => "incomplete",
            ConfigUpdate::Unchanged => "unchanged",
            ConfigUpdate::Changed(_) => "complete",
        }
    );
    Ok(())
}

pub fn config(&self, codec: VideoCodec) -> Option<&CodecConfig>

Return the latest complete configuration for codec.

pub fn reset(&mut self)

Clear all cached parameter sets and active configuration.

pub fn is_keyframe(codec: VideoCodec, data: &[u8]) -> Result<bool, VideoError>

Return true when the access unit contains a random-access NAL unit.

Trait Implementations

impl Clone for CodecConfigTracker

fn clone(&self) -> CodecConfigTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CodecConfigTracker

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

Formats the value using the given formatter.

impl Default for CodecConfigTracker

fn default() -> CodecConfigTracker

Returns the “default value” for a type.