Enum DecodePreference 

pub enum DecodePreference {
    Auto,
    CpuOnly,
    PreferHardware,
    RequireHardware,
}

User-facing decode preference for a feed.

Controls which decoder strategy the media backend uses when constructing the decode pipeline. The default is Auto, which preserves the backend’s existing selection heuristic.

This type is backend-neutral — it does not expose GStreamer element names, GPU memory modes, or inference-framework details.

Variant	Behavior
Auto	Backend picks the best available decoder (default).
CpuOnly	Force software decoding — never use a hardware decoder.
PreferHardware	Try hardware first; fall back to software silently.
RequireHardware	Demand hardware decoding; fail-fast if unavailable.

Variants

Auto

Automatically select the best decoder: prefer hardware, fall back to software. This is the current default behavior preserved exactly.

CpuOnly

Force software decoding. The backend must never attempt a hardware decoder. Useful in environments without GPU access or where deterministic CPU-only behaviour is required.

PreferHardware

Prefer hardware decoding, but fall back to software silently if no hardware decoder is available. No error is raised on fallback.

RequireHardware

Require hardware decoding. If no hardware decoder is available, the backend must fail-fast with a MediaError instead of silently falling back to software.

Trait Implementations

impl Clone for DecodePreference

fn clone(&self) -> DecodePreference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecodePreference

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

Formats the value using the given formatter.

impl Default for DecodePreference

fn default() -> DecodePreference

Returns the “default value” for a type.

impl Display for DecodePreference

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

Formats the value using the given formatter.

impl Hash for DecodePreference

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DecodePreference

fn eq(&self, other: &DecodePreference) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for DecodePreference

impl Eq for DecodePreference

impl StructuralPartialEq for DecodePreference