A JavaScript script create a 3-color palette for background and text colors based on an image. Inspired by iTunes 11.
JavaScript PHP
Latest commit 86db892 Feb 19, 2013 @chengyin Merge pull request #4 from 5thWall/master
Bigger image.
Permalink
Failed to load latest commit information.
examples/lastfm
README.md Fix typos and formatting in README Dec 13, 2012
albumcolors.js Set canvas width and height before adding image. Feb 15, 2013
screenshot.png

README.md

AlbumColors.js

Screenshot

A JavaScript script to pick 3 colors from an image to create a palette for background and text colors. Inspired by iTunes 11.

Examples

Hosted example showing album info generated from users' last.fm. Try it with your own username for different results.

How to Use

var url = 'http://www.google.com/images/srpr/logo3w.png',
    // You will need a image hosted under the same domain as the script
    albumColors = new AlbumColors(url);

albumColors.getColors(function(colors) {
    console.log(colors);
    // Result: [[254, 254, 254], [2, 138, 14], [4, 171, 21]]
});

Algorithm

The algorithm is simple.

  1. Load image from URL into canvas and get the color array by pixels (AlbumImage)

  2. Find n (default 10) major colors from the pixel array (AlbumColors)

    2.1. Divide color spectrum into 64 buckets

    2.2. Add each color into one of the bucket with a simple approximation

    2.3. Take the 10 buckets with the largest number of colors in them

    2.4. Averaging the colors in the dominating buckets to get the presenting color for the buckets

  3. Among the 10 major colors, pick out 3 (colorChooser)

    3.1. Color distance is simply defined as the Euclidean distance

    3.2. The most dominating color (ColorA) will be the background

    3.3. The color that is most distanced from ColorA, ColorB, will be text color 1

    3.4. The color that is second distanced form ColorA, ColorC, will be text color 2

Limitations

Images are loaded through canvas, therefore we are limited to the same origin rule. In the last.fm example, a simple image proxy is included to bypass the issue.

License

University of Illinois / NCSA