Enum OrientationHint 

#[non_exhaustive]
pub enum OrientationHint {
    Preserve,
    Correct,
    CorrectAndTransform(Orientation),
    ExactTransform(Orientation),
}

How the decoder should handle orientation during decode.

Replaces a simple with_orientation_hint(Orientation) with richer semantics: the caller can request orientation correction plus additional transforms, which the decoder can coalesce into a single operation (e.g., JPEG lossless DCT rotation).

Pass to DecodeJob::with_orientation().

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.

Preserve

Don’t touch orientation. Report intrinsic orientation in ImageInfo::orientation.

Correct

Resolve EXIF/container orientation to Identity.

The decoder coalesces this with the decode operation when possible (e.g., JPEG lossless DCT transform). The output ImageInfo will report Orientation::Identity.

CorrectAndTransform(Orientation)

Resolve EXIF orientation, then apply an additional transform.

The decoder coalesces the combined operation when possible. For example, if EXIF says Rotate90 and the hint says Rotate180, the decoder applies Rotate270 in a single step.

ExactTransform(Orientation)

Ignore EXIF orientation. Apply exactly this transform.

The EXIF orientation is not consulted. The given transform is applied literally.

Trait Implementations

impl Clone for OrientationHint

fn clone(&self) -> OrientationHint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OrientationHint

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

Formats the value using the given formatter.

impl Default for OrientationHint

fn default() -> OrientationHint

Returns the “default value” for a type.

impl Hash for OrientationHint

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 OrientationHint

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

impl Eq for OrientationHint

impl StructuralPartialEq for OrientationHint