Enum TransformWarning 

#[non_exhaustive]
pub enum TransformWarning {
    MetadataDropped(MetadataKind),
    OrientationDropped {
        orientation: u16,
    },
    TargetQualityNotReached {
        target: TargetQuality,
        achieved: f32,
        quality: u8,
    },
}

A non-fatal warning emitted during a transform operation.

Warnings indicate that the transform completed successfully but some aspect of the request could not be fully honored. Adapters should surface these to operators (e.g. CLI prints to stderr, server logs to stderr).

use truss::{MetadataKind, TransformWarning};

let warning = TransformWarning::MetadataDropped(MetadataKind::Xmp);
assert_eq!(
    format!("{warning}"),
    "XMP metadata was present in the input but could not be preserved by the output encoder"
);

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.

MetadataDropped(MetadataKind)

Metadata of the given kind was present in the input but could not be preserved by the output encoder and was silently dropped.

OrientationDropped

The input carries an EXIF orientation that the output records neither in its pixels nor in its metadata, so the output displays rotated relative to the input.

Fields

orientation: u16

The EXIF orientation value the input carried.

TargetQualityNotReached

No quality the search probed reached the requested target, so the output scores below it. Raised only for a target the caller named, never for the one auto picks on its own, and never when the input’s own bytes were handed back. The search samples the quality range rather than walking it, so this says no probed quality reached the target rather than that none would; see TargetQuality.

Fields

target: TargetQuality

The target that was asked for.

achieved: f32

The score the returned encode reached, which is the one at quality.

quality: u8

The quality of the encode returned: the quality cap when one was given, otherwise 100.

Trait Implementations

impl Clone for TransformWarning

fn clone(&self) -> TransformWarning

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransformWarning

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

Formats the value using the given formatter.

impl Display for TransformWarning

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

Formats the value using the given formatter.

impl PartialEq for TransformWarning

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TransformWarning