zenquant 0.1.1

AQ-informed palette quantizer — perceptual masking meets color quantization
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

use thiserror::Error;

/// Error returned from palette quantization operations.
#[derive(Debug, Clone, Error)]
#[non_exhaustive]
pub enum QuantizeError {
    /// Image dimensions cannot be zero.
    #[error("image dimensions cannot be zero")]
    ZeroDimension,

    /// Pixel buffer length does not match the declared width and height.
    #[error("pixel buffer length {len} does not match dimensions {width}x{height}")]
    DimensionMismatch {
        /// Actual length of the pixel buffer.
        len: usize,
        /// Declared image width.
        width: usize,
        /// Declared image height.
        height: usize,
    },

    /// `max_colors` must be between 2 and 256.
    #[error("max_colors must be between 2 and 256, got {0}")]
    InvalidMaxColors(u32),

    /// The quantized image did not meet the minimum SSIM2 quality threshold.
    #[error("quality target not met: wanted SSIM2 >= {min_ssim2:.1}, got {achieved_ssim2:.1}")]
    QualityNotMet {
        /// The minimum SSIM2 score that was required.
        min_ssim2: f32,
        /// The SSIM2 score actually achieved.
        achieved_ssim2: f32,
    },
}