Struct CodecRegistryHandle 

pub struct CodecRegistryHandle { /* private fields */ }

Thread-safe handle for codec registration/lookups.

Example

use std::sync::Arc;
use styx_codec::{Codec, CodecDescriptor, CodecError, CodecKind, CodecRegistry};
use styx_core::prelude::{FourCc, FrameLease};

struct Passthrough {
    desc: CodecDescriptor,
}

impl Codec for Passthrough {
    fn descriptor(&self) -> &CodecDescriptor { &self.desc }
    fn process(&self, input: FrameLease) -> Result<FrameLease, CodecError> { Ok(input) }
}

let registry = CodecRegistry::new();
registry.register(
    FourCc::new(*b"RG24"),
    Arc::new(Passthrough {
        desc: CodecDescriptor {
            kind: CodecKind::Decoder,
            input: FourCc::new(*b"RG24"),
            output: FourCc::new(*b"RG24"),
            name: "passthrough",
            impl_name: "passthrough",
        },
    }),
);
let handle = registry.handle();
let _ = handle.lookup(FourCc::new(*b"RG24"))?;

Implementations

impl CodecRegistryHandle

pub fn lookup(&self, fourcc: FourCc) -> Result<Arc<dyn Codec>, RegistryError>

Lookup a codec by FourCc.

pub fn lookup_named( &self, fourcc: FourCc, impl_name: &str, ) -> Result<Arc<dyn Codec>, RegistryError>

Lookup a codec by FourCc and implementation name.

pub fn lookup_named_kind( &self, fourcc: FourCc, kind: CodecKind, impl_name: &str, ) -> Result<Arc<dyn Codec>, RegistryError>

Lookup a codec by FourCc, kind, and implementation name.

pub fn lookup_preferred( &self, fourcc: FourCc, preferred_impls: &[&str], prefer_hardware: bool, ) -> Result<Arc<dyn Codec>, RegistryError>

Lookup a codec by FourCc honoring an ordered list of preferred impl names and hardware preference.

pub fn lookup_by_impl( &self, kind: CodecKind, impl_name: &str, ) -> Result<(FourCc, Arc<dyn Codec>), RegistryError>

Find a codec by implementation name and kind across all FourCc entries.

pub fn process( &self, fourcc: FourCc, frame: FrameLease, ) -> Result<FrameLease, RegistryError>

Process a frame with the registered codec.

pub fn process_named( &self, fourcc: FourCc, impl_name: &str, frame: FrameLease, ) -> Result<FrameLease, RegistryError>

Process with a specific implementation name.

pub fn process_preferred( &self, fourcc: FourCc, preferred_impls: &[&str], prefer_hardware: bool, frame: FrameLease, ) -> Result<FrameLease, RegistryError>

Process with an ordered implementation preference and optional hardware bias.

pub fn set_preference(&self, fourcc: FourCc, preference: Preference)

Configure preferences for a FourCc (impl order + hardware bias).

pub fn disable_impl(&self, fourcc: FourCc, impl_name: &str)

Disable a codec implementation by impl_name for the given FourCc.

pub fn enable_only(&self, fourcc: FourCc, impl_names: &[&str])

Enable only the listed impl_names for a FourCc (removes others).

pub fn register_dynamic(&self, fourcc: FourCc, codec: Arc<dyn Codec>)

Dynamically register a new codec impl at runtime.

pub fn set_impl_priority(&self, fourcc: FourCc, impl_name: &str, priority: i32)

Assign an explicit priority for an impl name (lower wins).

pub fn set_default_hardware_bias(&self, prefer: bool)

Toggle the default bias toward hardware implementations.

pub fn set_policy(&self, policy: CodecPolicy)

Install a full policy for a FourCc.

pub fn lookup_auto( &self, fourcc: FourCc, ) -> Result<Arc<dyn Codec>, RegistryError>

Lookup honoring stored preferences when present.

pub fn lookup_auto_kind( &self, fourcc: FourCc, kind: CodecKind, ) -> Result<Arc<dyn Codec>, RegistryError>

Lookup honoring stored preferences when present, constrained to a codec kind.

pub fn lookup_auto_kind_by_name( &self, fourcc: FourCc, kind: CodecKind, codec_name: &str, ) -> Result<Arc<dyn Codec>, RegistryError>

Lookup honoring stored preferences, constrained to a codec kind and algorithm family name.

pub fn process_auto( &self, fourcc: FourCc, frame: FrameLease, ) -> Result<FrameLease, RegistryError>

Process honoring stored preferences when present.

pub fn process_auto_kind( &self, fourcc: FourCc, kind: CodecKind, frame: FrameLease, ) -> Result<FrameLease, RegistryError>

Process honoring stored preferences when present, constrained to a codec kind.

pub fn process_auto_kind_by_name( &self, fourcc: FourCc, kind: CodecKind, codec_name: &str, frame: FrameLease, ) -> Result<FrameLease, RegistryError>

Process honoring stored preferences, constrained to a codec kind and algorithm family name.

pub fn stats(&self) -> CodecStats

Stats snapshot.

pub fn list_registered(&self) -> Vec<(FourCc, Vec<CodecDescriptor>)>

Snapshot of all registered codecs grouped by FourCc (descriptor-only).

pub fn list_registered_by_kind( &self, kind: CodecKind, ) -> Vec<(FourCc, Vec<CodecDescriptor>)>

List registered codecs filtered by kind.

Trait Implementations

impl Clone for CodecRegistryHandle

fn clone(&self) -> CodecRegistryHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.