Crate quantette

A library for fast and high quality image quantization and palette generation.

quantette can perform quantization in perceptually uniform color spaces like CIELAB and Oklab for more accurate results.

Features

To reduce dependencies and compile times, quantette has several cargo features that can be turned off or on:

• pipelines: exposes builder structs that serve as the high-level API (more details below).
• colorspaces: allows performing quantization in the CIELAB or Oklab color spaces via the high-level API.
• kmeans: adds an additional high quality quantization method that takes longer to run.
• threads: exposes parallel versions of most functions via rayon.
• image: enables integration with the image crate.

By default, all features are enabled.

High-Level API

To get started with the high-level API, see ImagePipeline. If you want a color palette instead of a quantized image, see PalettePipeline instead. Both of these have examples in their documentation, but here is an additional example:

let img = image::open("some image")?.into_rgb8();

let pipeline = ImagePipeline::try_from(&img)?
    .palette_size(128) // set the max number of colors in the palette
    .dither(false) // turn dithering off
    .colorspace(ColorSpace::Oklab) // use a more accurate color space
    .quantize_method(QuantizeMethod::kmeans());

// Run the pipeline in parallel to get a [`RgbImage`]
let quantized = pipeline.quantized_rgbimage_par();

Note that some of the options and functions above require certain features to be enabled.

Re-exports

• pub use image;
• pub use palette;

Modules

• kmeans
  Color quantization by k-means clustering.
• wu
  Wu’s color quantizer (Greedy Orthogonal Bipartitioning).

Structs

• AboveMaxLen
  An error type for when the length of an input (e.g., Vec or slice) is above the maximum supported value.
• ColorSlice
  A simple new type wrapper around &'a [Color] with the invariant that the length of the inner slice must not be greater than MAX_PIXELS.
• FloydSteinberg
  Floyd–Steinberg dithering.
• ImagePipeline
  A builder struct to specify options to create a quantized image or an indexed palette from an image.
• IndexedColorCounts
  Deduplicated colors and their frequency counts.
• KmeansOptions
  A builder struct to specify the parameters for k-means.
• PalettePipeline
  A builder struct to specify options to create a color palette for an image or slice of colors.
• PaletteSize
  This type is used to specify the (maximum) number of colors to include in a palette.
• QuantizeOutput
  The output struct returned by quantization functions.
• UniqueColorCounts
  Deduplicated colors and their frequency counts.
• WuOptions
  A builder struct to specify the parameters for Wu’s quantization method.

Enums

• ColorSpace
  The set of supported color spaces that can be used when performing color quantization.
• QuantizeMethod
  The set of supported color quantization methods.

Constants

• MAX_COLORS
  The maximum supported number of palette colors is 256.
• MAX_PIXELS
  The maximum supported image size in number of pixels is u32::MAX.

Traits

• ColorComponents
  Types that may be cast to and from a fixed sized array.
• ColorCounts
  A generalization trait over regular ColorSlices and deduplicated pixels like UniqueColorCounts.
• ColorCountsParallelRemap
  Types that allow reconstructing the original image/color slice in parallel from a Vec of indices into a color palette.
• ColorCountsRemap
  Types that allow reconstructing the original image/color slice from a Vec of indices into a color palette.
• SumPromotion
  A numerical trait used to prevent overflow when summing any Count number of Selfs.
• ZeroedIsZero
  A marker trait signifying that the “zero value” for the type can be represented by the all zeros bit pattern.