#color #dockerfile #creative #static #test #images

bin+lib dither

A ditherer for static images with a variety of color palettes

22 releases (stable)

1.3.8 Sep 4, 2020
1.3.7 Oct 7, 2019
1.3.6 Mar 31, 2019
1.2.1 Feb 25, 2019
0.2.1 Jan 30, 2019

#19 in Images

Download history 29/week @ 2020-06-05 29/week @ 2020-06-12 1/week @ 2020-06-19 5/week @ 2020-06-26 49/week @ 2020-07-03 48/week @ 2020-07-10 26/week @ 2020-07-17 25/week @ 2020-07-24 2/week @ 2020-07-31 55/week @ 2020-08-07 30/week @ 2020-08-14 39/week @ 2020-08-21 35/week @ 2020-08-28 118/week @ 2020-09-04 8/week @ 2020-09-11 10/week @ 2020-09-18

149 downloads per month

MIT license

595KB
994 lines

Dither 1.3.7

Inspired by: http://www.tannerhelland.com/4660/dithering-eleven-algorithms-source-code/

License: MIT

The test photo ( "bunny.png" ) was obtained under the creative common license and is in the public domain.

Installation

  • Compilation from source

    • Install rust by following the instructions at rustup.rs/

    • Install dither

        cargo install dither
      
  • Download a binary (x64-windows, x64-linux)

  • Run directly via Docker

      docker run efronlicht/dither:latest
    

CLI help:

dither --help

usage

dither INPUT [OUTPUT] [-v] [--dither="floyd"] [--color="bw"] [--depth="1"] [--help]

examples

# no-op

bunny

dither bunny.png burkes.png --dither=burkes

burkes

dither bunny.png crayon.png --color=crayon

crayon

Args

INPUT

the path to an input image.known good image formats are .png and .jpg .

OUTPUT

the path to write the output.this will create or truncate the file at the existing location, if necessary.the image type will be inferred from the filename.currently, only .png and .jpg are supported.

-c , --color

The color mode to use. Default is "bw" (black and white). Available options are

  • bw (default)
  • color
  • cga
  • crayon
  • $COLOR
  • $FILENAME

--color=bw (default)

grayscale mode.dither to --depth bits; --depth=1 uses pure black and white, --depth=2 uses black, white, and two shades of gray, etc, etc.

color=color

use RGB channels with specified bit depth.i.e, --color=color, --depth=2 uses two bits each for the red, green, and blue channels.

--color=crayon

use the crayon color palette.see "crayon.plt" for details.

--color=cga

use the cga color palette.see the wikipedia article or "cga.plt" for details.

--color=$COLOR

single-color mode.dither in black and white to the specified bit depth, then replace white with the given color, using black for the background.

  • BLUE
  • GREEN
  • CYAN
  • RED
  • MAGENTA
  • BROWN
  • LIGHT_GRAY
  • GRAY
  • LIGHT_BLUE
  • LIGHT_GREEN
  • LIGHT_CYAN
  • LIGHT_RED
  • LIGHT_MAGENTA
  • YELLOW
  • WHITE

--color=$FILENAME

load a palette from file.palettes are specified as a list of two or more newline-separated 24-bit hexidecimals, with optional 0x prefix.see crayon.plt and cga.plt for examples.

// WHITE
0xffffff
// BLACK
0x000000
// RED
0xff0000
// GREEN
0x00ff00
// BLUE
0x0000ff

-d, --dither

The type of ditherer to use. Available options are

  • "floyd" , "steinberg" , "floydsteinberg" (default)
  • "atkinson" ,
  • "stucki" ,
  • "burkes" ,
  • "jarvis" , "judice" , ninke"
  • "sierra" , "sierra3"

See the documentation or Tanner Helland's article for technical details.

-v, --verbose

Verbose debug output to stderr.

--depth

The bit depth to compress each channel to. Should be an unsigned integer between 1 and 7 (default 1). Mutally exclusive with the --color= $FILENAME , color==cga , and --color=crayon options.

Dependencies

~3.5MB
~63K SLoC