color-thief/README.markdown

Color Thief

by Lokesh Dhakar - Blog - Twitter

A script for grabbing the dominant color or a representative color palette from an image. Uses javascript and canvas.

Demo

##Requirements

• jQuery
• quantize.js

##Usage

###getDominantColor(sourceImage) returns {r: num, g: num, b: num}

Use the median cut algorithm provided by quantize.js to cluster similar colors and return the base color from the largest cluster.

###createPalette(sourceImage, colorCount) returns array[ {r: num, g: num, b: num}, {r: num, g: num, b: num}, ...]

Use the median cut algorithm provided by quantize.js to cluster similar colors.

BUGGY: Function does not always return the requested amount of colors. It can be +/- 2.

Licensed under the Creative Commons Attribution 2.5 License