Enum ConvertError 

#[non_exhaustive]
pub enum ConvertError {
    NoMatch {
        source: PixelDescriptor,
    },
    NoPath {
        from: PixelDescriptor,
        to: PixelDescriptor,
    },
    BufferSize {
        expected: usize,
        actual: usize,
    },
    InvalidWidth(u32),
    EmptyFormatList,
    UnsupportedTransfer {
        from: TransferFunction,
        to: TransferFunction,
    },
    AlphaNotOpaque,
    DepthReductionForbidden,
    AlphaRemovalForbidden,
    RgbToGray,
    AllocationFailed,
    Buffer(BufferError),
    CmsError(String),
}

Errors that can occur during pixel format negotiation or conversion.

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.

NoMatch

No supported format could be found for the source descriptor.

Fields

source: PixelDescriptor

NoPath

No conversion path exists between the two formats.

Fields

from: PixelDescriptor

to: PixelDescriptor

BufferSize

Source and destination buffer sizes don’t match the expected dimensions.

Fields

expected: usize

actual: usize

InvalidWidth(u32)

Width is zero or would overflow stride calculations.

EmptyFormatList

The supported format list was empty.

UnsupportedTransfer

Conversion between these transfer functions is not yet supported.

Fields

from: TransferFunction

to: TransferFunction

AlphaNotOpaque

Alpha channel is not fully opaque and AlphaPolicy::DiscardIfOpaque was set.

DepthReductionForbidden

Depth reduction was requested but DepthPolicy::Forbid was set.

AlphaRemovalForbidden

Alpha removal was requested but AlphaPolicy::Forbid was set.

RgbToGray

RGB-to-grayscale conversion requires explicit luma coefficients.

AllocationFailed

Buffer allocation failed.

Buffer(BufferError)

A pixel buffer or slice could not be constructed: carries the real zenpixels::BufferError cause (StrideTooSmall, InvalidDimensions, …) instead of collapsing it into AllocationFailed.

CmsError(String)

CMS transform could not be built (invalid ICC profile, unsupported color space, etc.).

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

Available on crate feature std only.

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

fn from(err: BufferError) -> Self

Wrap a buffer-construction failure’s real cause into ConvertError::Buffer. Pair with map_err_at at the call sites so the At location trace is preserved alongside the classified cause.

impl PartialEq for ConvertError

fn eq(&self, other: &ConvertError) -> 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 StructuralPartialEq for ConvertError