Skip to content

Latest commit

 

History

History
32 lines (20 loc) · 1.28 KB

README.md

File metadata and controls

32 lines (20 loc) · 1.28 KB

dither-nim

Dithering algorithms implemented in Nim

API

API Documentation

Algorithms

This library supports two primary classifications of algorithms:

  • Ordered Dithering: This is a fast dithering algorithm that uses a matrix of predefined values to vary what color is selected.
  • Error Diffusion: A slightly slower dithering algorithm that tracks the error incurred when a color is clamped to the palette, then distributes that error to surrounding pixels.

A more detailed list of supported algorithms can be found here:

https://nycto.github.io/dither-nim/dither/types.html#DitherModes

Example

A working example that uses pixie for images and chroma for colors can be seen here:

https://github.com/Nycto/dither-nim/blob/main/example/src/dither_img.nim

A note on concepts

This library uses Nim concepts to control the inputs to its algorithms. This allows it to integrate with arbitrary image, color, and palette libraries -- as long as they implement the interface described by the concepts.