Enum ConvertError 

#[non_exhaustive]
pub enum ConvertError {
    NullFrame,
    TooManyPixels(TooManyPixels),
    FrameTooLarge(FrameTooLarge),
    InvalidSampleCount(InvalidSampleCount),
    InvalidDimensions(InvalidDimensions),
    ImageSideDataTooLarge(ImageSideDataTooLarge),
    ImageSideDataEntries(ImageSideDataEntries),
    UnsupportedSampleFormat(UnsupportedSampleFormat),
    UnsupportedChannelCount(UnsupportedChannelCount),
    UnsupportedPixelFormat(UnsupportedPixelFormat),
    InvalidPlaneLayout(InvalidPlaneLayout),
    BufferAcquireFailed(BufferAcquireFailed),
    CarrierAllocFailed(CarrierAllocFailed),
}

Errors from av_frame_to_video_frame.

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.

NullFrame

av_frame was null.

TooManyPixels(TooManyPixels)

The frame declares more pixels than the ceiling allows. Refused before any plane is allocated.

FrameTooLarge(FrameTooLarge)

The frame’s planes would export more bytes than the ceiling allows. Refused before any plane is allocated.

InvalidSampleCount(InvalidSampleCount)

An audio frame declares a negative sample count.

InvalidDimensions(InvalidDimensions)

A picture frame declares a negative width or height.

ImageSideDataTooLarge(ImageSideDataTooLarge)

A decoded still’s side data is larger than the ceiling allows.

ImageSideDataEntries(ImageSideDataEntries)

A decoded still declares more side-data entries than this crate will walk.

UnsupportedSampleFormat(UnsupportedSampleFormat)

An audio frame’s sample format has no byte width.

UnsupportedChannelCount(UnsupportedChannelCount)

An audio frame’s channel count is one this crate will not carry.

UnsupportedPixelFormat(UnsupportedPixelFormat)

The frame’s pixel format isn’t in the closed CPU-format set this crate supports for safe per-plane access.

InvalidPlaneLayout(InvalidPlaneLayout)

A plane reported linesize <= 0 or otherwise inconsistent layout.

BufferAcquireFailed(BufferAcquireFailed)

A plane’s data[i] does not lie inside any of the frame’s own buf[] allocations, so its extent cannot be proved.

CarrierAllocFailed(CarrierAllocFailed)

The plane’s extent was proved and the carrier still could not be made. See CarrierAllocFailed.

Implementations

impl ConvertError

pub const fn is_null_frame(&self) -> bool

Returns true if this value is of type NullFrame. Returns false otherwise

pub const fn is_too_many_pixels(&self) -> bool

Returns true if this value is of type TooManyPixels. Returns false otherwise

pub const fn is_frame_too_large(&self) -> bool

Returns true if this value is of type FrameTooLarge. Returns false otherwise

pub const fn is_invalid_sample_count(&self) -> bool

Returns true if this value is of type InvalidSampleCount. Returns false otherwise

pub const fn is_invalid_dimensions(&self) -> bool

Returns true if this value is of type InvalidDimensions. Returns false otherwise

pub const fn is_image_side_data_too_large(&self) -> bool

Returns true if this value is of type ImageSideDataTooLarge. Returns false otherwise

pub const fn is_image_side_data_entries(&self) -> bool

Returns true if this value is of type ImageSideDataEntries. Returns false otherwise

pub const fn is_unsupported_sample_format(&self) -> bool

Returns true if this value is of type UnsupportedSampleFormat. Returns false otherwise

pub const fn is_unsupported_channel_count(&self) -> bool

Returns true if this value is of type UnsupportedChannelCount. Returns false otherwise

pub const fn is_unsupported_pixel_format(&self) -> bool

Returns true if this value is of type UnsupportedPixelFormat. Returns false otherwise

pub const fn is_invalid_plane_layout(&self) -> bool

Returns true if this value is of type InvalidPlaneLayout. Returns false otherwise

pub const fn is_buffer_acquire_failed(&self) -> bool

Returns true if this value is of type BufferAcquireFailed. Returns false otherwise

pub const fn is_carrier_alloc_failed(&self) -> bool

Returns true if this value is of type CarrierAllocFailed. Returns false otherwise

impl ConvertError

pub fn unwrap_null_frame(self)

Unwraps this value to the ConvertError::NullFrame variant. Panics if this value is of any other type.

pub fn unwrap_null_frame_ref(&self)

Unwraps this reference to the ConvertError::NullFrame variant. Panics if this value is of any other type.

pub fn unwrap_null_frame_mut(&mut self)

Unwraps this mutable reference to the ConvertError::NullFrame variant. Panics if this value is of any other type.

pub fn unwrap_too_many_pixels(self) -> TooManyPixels

Unwraps this value to the ConvertError::TooManyPixels variant. Panics if this value is of any other type.

pub fn unwrap_too_many_pixels_ref(&self) -> &TooManyPixels

Unwraps this reference to the ConvertError::TooManyPixels variant. Panics if this value is of any other type.

pub fn unwrap_too_many_pixels_mut(&mut self) -> &mut TooManyPixels

Unwraps this mutable reference to the ConvertError::TooManyPixels variant. Panics if this value is of any other type.

pub fn unwrap_frame_too_large(self) -> FrameTooLarge

Unwraps this value to the ConvertError::FrameTooLarge variant. Panics if this value is of any other type.

pub fn unwrap_frame_too_large_ref(&self) -> &FrameTooLarge

Unwraps this reference to the ConvertError::FrameTooLarge variant. Panics if this value is of any other type.

pub fn unwrap_frame_too_large_mut(&mut self) -> &mut FrameTooLarge

Unwraps this mutable reference to the ConvertError::FrameTooLarge variant. Panics if this value is of any other type.

pub fn unwrap_invalid_sample_count(self) -> InvalidSampleCount

Unwraps this value to the ConvertError::InvalidSampleCount variant. Panics if this value is of any other type.

pub fn unwrap_invalid_sample_count_ref(&self) -> &InvalidSampleCount

Unwraps this reference to the ConvertError::InvalidSampleCount variant. Panics if this value is of any other type.

pub fn unwrap_invalid_sample_count_mut(&mut self) -> &mut InvalidSampleCount

Unwraps this mutable reference to the ConvertError::InvalidSampleCount variant. Panics if this value is of any other type.

pub fn unwrap_invalid_dimensions(self) -> InvalidDimensions

Unwraps this value to the ConvertError::InvalidDimensions variant. Panics if this value is of any other type.

pub fn unwrap_invalid_dimensions_ref(&self) -> &InvalidDimensions

Unwraps this reference to the ConvertError::InvalidDimensions variant. Panics if this value is of any other type.

pub fn unwrap_invalid_dimensions_mut(&mut self) -> &mut InvalidDimensions

Unwraps this mutable reference to the ConvertError::InvalidDimensions variant. Panics if this value is of any other type.

pub fn unwrap_image_side_data_too_large(self) -> ImageSideDataTooLarge

Unwraps this value to the ConvertError::ImageSideDataTooLarge variant. Panics if this value is of any other type.

pub fn unwrap_image_side_data_too_large_ref(&self) -> &ImageSideDataTooLarge

Unwraps this reference to the ConvertError::ImageSideDataTooLarge variant. Panics if this value is of any other type.

pub fn unwrap_image_side_data_too_large_mut( &mut self, ) -> &mut ImageSideDataTooLarge

Unwraps this mutable reference to the ConvertError::ImageSideDataTooLarge variant. Panics if this value is of any other type.

pub fn unwrap_image_side_data_entries(self) -> ImageSideDataEntries

Unwraps this value to the ConvertError::ImageSideDataEntries variant. Panics if this value is of any other type.

pub fn unwrap_image_side_data_entries_ref(&self) -> &ImageSideDataEntries

Unwraps this reference to the ConvertError::ImageSideDataEntries variant. Panics if this value is of any other type.

pub fn unwrap_image_side_data_entries_mut( &mut self, ) -> &mut ImageSideDataEntries

Unwraps this mutable reference to the ConvertError::ImageSideDataEntries variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_sample_format(self) -> UnsupportedSampleFormat

Unwraps this value to the ConvertError::UnsupportedSampleFormat variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_sample_format_ref(&self) -> &UnsupportedSampleFormat

Unwraps this reference to the ConvertError::UnsupportedSampleFormat variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_sample_format_mut( &mut self, ) -> &mut UnsupportedSampleFormat

Unwraps this mutable reference to the ConvertError::UnsupportedSampleFormat variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_channel_count(self) -> UnsupportedChannelCount

Unwraps this value to the ConvertError::UnsupportedChannelCount variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_channel_count_ref(&self) -> &UnsupportedChannelCount

Unwraps this reference to the ConvertError::UnsupportedChannelCount variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_channel_count_mut( &mut self, ) -> &mut UnsupportedChannelCount

Unwraps this mutable reference to the ConvertError::UnsupportedChannelCount variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_pixel_format(self) -> UnsupportedPixelFormat

Unwraps this value to the ConvertError::UnsupportedPixelFormat variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_pixel_format_ref(&self) -> &UnsupportedPixelFormat

Unwraps this reference to the ConvertError::UnsupportedPixelFormat variant. Panics if this value is of any other type.

pub fn unwrap_unsupported_pixel_format_mut( &mut self, ) -> &mut UnsupportedPixelFormat

Unwraps this mutable reference to the ConvertError::UnsupportedPixelFormat variant. Panics if this value is of any other type.

pub fn unwrap_invalid_plane_layout(self) -> InvalidPlaneLayout

Unwraps this value to the ConvertError::InvalidPlaneLayout variant. Panics if this value is of any other type.

pub fn unwrap_invalid_plane_layout_ref(&self) -> &InvalidPlaneLayout

Unwraps this reference to the ConvertError::InvalidPlaneLayout variant. Panics if this value is of any other type.

pub fn unwrap_invalid_plane_layout_mut(&mut self) -> &mut InvalidPlaneLayout

Unwraps this mutable reference to the ConvertError::InvalidPlaneLayout variant. Panics if this value is of any other type.

pub fn unwrap_buffer_acquire_failed(self) -> BufferAcquireFailed

Unwraps this value to the ConvertError::BufferAcquireFailed variant. Panics if this value is of any other type.

pub fn unwrap_buffer_acquire_failed_ref(&self) -> &BufferAcquireFailed

Unwraps this reference to the ConvertError::BufferAcquireFailed variant. Panics if this value is of any other type.

pub fn unwrap_buffer_acquire_failed_mut(&mut self) -> &mut BufferAcquireFailed

Unwraps this mutable reference to the ConvertError::BufferAcquireFailed variant. Panics if this value is of any other type.

pub fn unwrap_carrier_alloc_failed(self) -> CarrierAllocFailed

Unwraps this value to the ConvertError::CarrierAllocFailed variant. Panics if this value is of any other type.

pub fn unwrap_carrier_alloc_failed_ref(&self) -> &CarrierAllocFailed

Unwraps this reference to the ConvertError::CarrierAllocFailed variant. Panics if this value is of any other type.

pub fn unwrap_carrier_alloc_failed_mut(&mut self) -> &mut CarrierAllocFailed

Unwraps this mutable reference to the ConvertError::CarrierAllocFailed variant. Panics if this value is of any other type.

impl ConvertError

pub fn try_unwrap_null_frame(self) -> Result<(), TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::NullFrame variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_null_frame_ref(&self) -> Result<(), TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::NullFrame variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_null_frame_mut( &mut self, ) -> Result<(), TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::NullFrame variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_too_many_pixels( self, ) -> Result<TooManyPixels, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::TooManyPixels variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_too_many_pixels_ref( &self, ) -> Result<&TooManyPixels, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::TooManyPixels variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_too_many_pixels_mut( &mut self, ) -> Result<&mut TooManyPixels, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::TooManyPixels variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_frame_too_large( self, ) -> Result<FrameTooLarge, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::FrameTooLarge variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_frame_too_large_ref( &self, ) -> Result<&FrameTooLarge, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::FrameTooLarge variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_frame_too_large_mut( &mut self, ) -> Result<&mut FrameTooLarge, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::FrameTooLarge variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_sample_count( self, ) -> Result<InvalidSampleCount, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::InvalidSampleCount variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_sample_count_ref( &self, ) -> Result<&InvalidSampleCount, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::InvalidSampleCount variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_sample_count_mut( &mut self, ) -> Result<&mut InvalidSampleCount, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::InvalidSampleCount variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_dimensions( self, ) -> Result<InvalidDimensions, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::InvalidDimensions variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_dimensions_ref( &self, ) -> Result<&InvalidDimensions, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::InvalidDimensions variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_dimensions_mut( &mut self, ) -> Result<&mut InvalidDimensions, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::InvalidDimensions variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_image_side_data_too_large( self, ) -> Result<ImageSideDataTooLarge, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::ImageSideDataTooLarge variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_image_side_data_too_large_ref( &self, ) -> Result<&ImageSideDataTooLarge, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::ImageSideDataTooLarge variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_image_side_data_too_large_mut( &mut self, ) -> Result<&mut ImageSideDataTooLarge, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::ImageSideDataTooLarge variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_image_side_data_entries( self, ) -> Result<ImageSideDataEntries, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::ImageSideDataEntries variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_image_side_data_entries_ref( &self, ) -> Result<&ImageSideDataEntries, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::ImageSideDataEntries variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_image_side_data_entries_mut( &mut self, ) -> Result<&mut ImageSideDataEntries, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::ImageSideDataEntries variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_sample_format( self, ) -> Result<UnsupportedSampleFormat, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::UnsupportedSampleFormat variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_sample_format_ref( &self, ) -> Result<&UnsupportedSampleFormat, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::UnsupportedSampleFormat variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_sample_format_mut( &mut self, ) -> Result<&mut UnsupportedSampleFormat, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::UnsupportedSampleFormat variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_channel_count( self, ) -> Result<UnsupportedChannelCount, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::UnsupportedChannelCount variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_channel_count_ref( &self, ) -> Result<&UnsupportedChannelCount, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::UnsupportedChannelCount variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_channel_count_mut( &mut self, ) -> Result<&mut UnsupportedChannelCount, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::UnsupportedChannelCount variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_pixel_format( self, ) -> Result<UnsupportedPixelFormat, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::UnsupportedPixelFormat variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_pixel_format_ref( &self, ) -> Result<&UnsupportedPixelFormat, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::UnsupportedPixelFormat variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_unsupported_pixel_format_mut( &mut self, ) -> Result<&mut UnsupportedPixelFormat, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::UnsupportedPixelFormat variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_plane_layout( self, ) -> Result<InvalidPlaneLayout, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::InvalidPlaneLayout variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_plane_layout_ref( &self, ) -> Result<&InvalidPlaneLayout, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::InvalidPlaneLayout variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_invalid_plane_layout_mut( &mut self, ) -> Result<&mut InvalidPlaneLayout, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::InvalidPlaneLayout variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_buffer_acquire_failed( self, ) -> Result<BufferAcquireFailed, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::BufferAcquireFailed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_buffer_acquire_failed_ref( &self, ) -> Result<&BufferAcquireFailed, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::BufferAcquireFailed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_buffer_acquire_failed_mut( &mut self, ) -> Result<&mut BufferAcquireFailed, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::BufferAcquireFailed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_carrier_alloc_failed( self, ) -> Result<CarrierAllocFailed, TryUnwrapError<Self>>

Attempts to unwrap this value to the ConvertError::CarrierAllocFailed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_carrier_alloc_failed_ref( &self, ) -> Result<&CarrierAllocFailed, TryUnwrapError<&Self>>

Attempts to unwrap this reference to the ConvertError::CarrierAllocFailed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_carrier_alloc_failed_mut( &mut self, ) -> Result<&mut CarrierAllocFailed, TryUnwrapError<&mut Self>>

Attempts to unwrap this mutable reference to the ConvertError::CarrierAllocFailed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

Trait Implementations

impl Clone for ConvertError

fn clone(&self) -> ConvertError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConvertError

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

Formats the value using the given formatter.

impl Display for ConvertError

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

Formats the value using the given formatter.

impl Error for ConvertError

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<ConvertError> for AudioDecodeError

fn from(source: ConvertError) -> Self

Converts to this type from the input type.

impl From<ConvertError> for ImageDecodeError

fn from(source: ConvertError) -> Self

Converts to this type from the input type.

impl From<ConvertError> for SubtitleDecodeError

fn from(source: ConvertError) -> Self

Converts to this type from the input type.

impl From<ConvertError> for VideoDecodeError

fn from(source: ConvertError) -> Self

Converts to this type from the input type.