TiledPaletteQuantCLI

A NodeJS command line interface port of rilden's fantastic tile palette quantization / dithering tool https://rilden.github.io/tiledpalettequant/ (https://github.com/rilden/tiledpalettequant)/

An additional feature added is the ability to vertically split the quantized image. This can be used to quantize multiple images using a shared set of palettes.

Note that this has only been tested in WSL so your milage may vary running on other platforms (anything with a terminal that can run NodeJS should work though).

Installation

With a recent version of NodeJS installed, run one of the following:

• npm install tiledpalettequantcli
• npx tiledpalettequantcli
• npm install tiledpalettequantcli -g (to install globally)

Usage

In the terminal, run npx tiledpalettequantcli [Options] or tiledpalettequantcli [Options] (depending if you installed locally or globally)

Options: | | | | |---|---|---| | -f | --file [f] | Input file to quantize (can also accept images from stdin if this option not included) | | -v | --vsplit [v] | Split resulting file into vertical chunks of [v] pixels each | | -o | --output [prefix] | Output name prefix (default is the current directory name) | | -si | --startIndex [si] | Start index for output names (default is no suffix if not needed, 0 if using --vsplit) | | -tw | --tileWidth [width] | Tile width px (default: 8) | | -th | --tileHeight [height] | Tile height px (default: 8) | | -p | --palettes [p] | Number of palettes (default: 1) | | -cpp | --colorsPerPalette [cpp] | Colors per palette (default: 16) | | -bpc | --bitsPerChannel [bpc] | Bits per channel (default: 5) | | -fp | --fractionOfPixels [fp] | Fraction of Pixels (default: 0.1) | | -czb | --colorZeroBehaviour [czb] | Color index zero behaviour (choices: "Unique", "Shared", "TransparentFromTransparent", "TransparentFromColor", default: "TransparentFromColor") | | -cz | --colorZero [cz] | Color index Zero (hex formated: #RRGGBB) (default: "#000000") | | -d | --ditherMethod [d] | Dithering Method (choices: "Off", "Fast", "Slow", default: "Off") | | -dw | --ditherWeight [dw] | Dither weight (default: 0.3) | | -dp | --ditherPattern [dp] | Dithering Pattern (choices: "Diagonal4", "Diagonal2", "Horizontal2", "Horizontal4", "Vertical2", "Vertical4", default: "Diagonal4") | | -h | --help | display help for command |

Examples

npx tiledpalettequantcli -f test.png

cat test.png | npx tiledpalettequantcli

npx tiledpalettequantcli -f example.png --ditherMethod Fast --ditherPattern Horizontal2

Using an external tool to resize and quantize multiple source images at once:

magick *.jpg -background 'rgba(0,0,0,0)' -resize '240' -gravity Center -extent 256x256 -append png:- | npx tiledpalettequantcli -output sharedPaletteExample -vsplit 256 -d Slow -p 5