Struct CodecRegistry 

pub struct CodecRegistry { /* private fields */ }

Implementations

impl CodecRegistry

pub fn new() -> Self

pub fn register(&mut self, info: CodecInfo)

Register one codec. Expands into:

• an entry in the id → implementations map (for make_decoder / make_encoder);
• an entry in the tag index for every claimed tag (for resolve_tag).

Calling register multiple times with the same id is allowed and how multi-implementation codecs (software-plus-hardware FLAC, for example) are expressed.

pub fn has_decoder(&self, id: &CodecId) -> bool

pub fn has_encoder(&self, id: &CodecId) -> bool

pub fn first_decoder( &self, params: &CodecParameters, ) -> Result<Box<dyn Decoder>>

First registered decoder factory for params.codec_id, invoked with params. No priority walk, no preference filter, no init-time fallback to a lower-priority impl. Errors if no decoder is registered for the codec.

Intended for single-impl scenarios — typically a codec crate’s own self-tests, where exactly one impl has been registered into a freshly-constructed registry. Production callers selecting among multiple candidates (e.g. h264_sw vs h264_videotoolbox) should use oxideav_pipeline::make_decoder_with instead, which applies CodecPreferences and walks priorities.

pub fn first_encoder( &self, params: &CodecParameters, ) -> Result<Box<dyn Encoder>>

First registered encoder factory — see first_decoder.

pub fn decoder_by_impl( &self, impl_name: &str, params: &CodecParameters, ) -> Result<Box<dyn Decoder>>

Look up a decoder by exact implementation name ("h264_sw", "aac_audiotoolbox", …). Errors if the impl isn’t registered or if it has no decoder factory.

pub fn encoder_by_impl( &self, impl_name: &str, params: &CodecParameters, ) -> Result<Box<dyn Encoder>>

Look up an encoder by exact implementation name — see decoder_by_impl.

pub fn decoder_ids(&self) -> impl Iterator<Item = &CodecId>

Iterate codec ids that have at least one decoder implementation.

pub fn encoder_ids(&self) -> impl Iterator<Item = &CodecId>

pub fn implementations(&self, id: &CodecId) -> &[CodecImplementation]

All registered implementations of a given codec id.

pub fn encoder_options_schema( &self, id: &CodecId, ) -> Option<&'static [OptionField]>

Lookup the encoder options schema for a registered codec. Walks implementations in registration order and returns the first schema found. None means either the codec isn’t registered or no implementation declared an encoder schema.

pub fn decoder_options_schema( &self, id: &CodecId, ) -> Option<&'static [OptionField]>

Lookup the decoder options schema — see encoder_options_schema.

pub fn all_implementations( &self, ) -> impl Iterator<Item = (&CodecId, &CodecImplementation)>

Iterator over every (codec_id, impl) pair — useful for oxideav list to show capability flags per implementation.

pub fn all_tag_registrations( &self, ) -> impl Iterator<Item = (&CodecTag, &CodecId)>

Iterator over every (tag, codec_id) pair currently registered — used by oxideav tags debug output and by tests that want to walk the tag surface.

pub fn resolve_tag_ref(&self, ctx: &ProbeContext<'_>) -> Option<&CodecId>

Inherent form of tag resolution that returns a reference. The owned-value form used by container code lives behind the CodecResolver trait impl below.

Walks every registration that claimed ctx.tag, calls its probe with ctx, and returns the id of the registration that scored highest. Probes that return 0.0 are discarded; ties on confidence are broken by registration order (first wins). Registrations with no probe are treated as returning 1.0.

Trait Implementations

impl CodecResolver for CodecRegistry

Implement the shared CodecResolver interface so container demuxers can accept &dyn CodecResolver without depending on this crate directly — the trait lives in oxideav-core.

fn resolve_tag(&self, ctx: &ProbeContext<'_>) -> Option<CodecId>

Resolve the tag in ctx.tag to a codec id. Implementations walk every registration whose tag set contains the tag, call each probe (treating None as “always 1.0”), and return the id with the highest resulting confidence. Ties are broken by registration order.

impl Default for CodecRegistry

fn default() -> CodecRegistry

Returns the “default value” for a type.