Enum HlsEncoderSelectionError 

#[non_exhaustive]
pub enum HlsEncoderSelectionError {
    HistoricalDefaultUnavailable {
        registered_auto_candidates: Vec<String>,
        registered_explicit_h264_encoders: Vec<String>,
    },
    AutoSelectionFailed {
        attempts: Vec<HlsEncoderAttempt>,
    },
    ExplicitOpenFailed {
        encoder: String,
        width: u32,
        height: u32,
        raw_code: i32,
        message: String,
    },
}

Failure to select a video encoder for crate::recipes::HlsLadder.

The historical default (libx264) is never silently replaced. Callers either get this typed error or opt in with HlsLadder::video_codec_auto.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

HistoricalDefaultUnavailable

HlsLadder was left on its historical libx264 default, and that encoder is not registered in the linked FFmpeg build. No fallback was selected.

Fields

registered_auto_candidates: Vec<String>

Auto-admitted H.264 encoder names that are registered. Presence here is not runtime-ready and does not prove HLS alignment.

registered_explicit_h264_encoders: Vec<String>

Other registered H.264 encoders that can only be chosen with .video_codec(...); this recipe does not manage their alignment.

AutoSelectionFailed

HlsLadder::video_codec_auto ran after libx264 was unavailable and no candidate could be opened for every rendition.

Fields

attempts: Vec<HlsEncoderAttempt>

One entry per auto-priority encoder, in selection order.

ExplicitOpenFailed

A pinned auto-admitted encoder (.video_codec("h264_qsv") and the other AUTO_PRIORITY names) failed trial-open (rungs are opened one by one; all sessions are held concurrently to prove the ladder’s session count). No other encoder was tried, and output directories were not created.

Fields

encoder: String

Encoder name the caller pinned.

width: u32

Width of the rendition that failed to open.

height: u32

Height of the rendition that failed to open.

raw_code: i32

Raw FFmpeg AVERROR code from avcodec_open2 (or setup).

message: String

av_strerror text for raw_code.

Trait Implementations

impl Clone for HlsEncoderSelectionError

fn clone(&self) -> HlsEncoderSelectionError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HlsEncoderSelectionError

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

Formats the value using the given formatter.

impl Display for HlsEncoderSelectionError

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

Formats the value using the given formatter.

impl Error for HlsEncoderSelectionError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<HlsEncoderSelectionError> for Error

fn from(err: HlsEncoderSelectionError) -> Self

Converts to this type from the input type.