RGBaster

A dead simple javascript library for extracting the dominant color(s) from an image.

Usage

Usage is simple. Create an image (or grab an image URL), then get its dominant color & palette.

var img = document.getElementById('image');
// or
var img = 'http://example.com/path-to-image.jpg'

RGBaster.colors(img, {
  success: function(payload) {
    // You now have the payload.
    console.log(payload.dominant);
    console.log(payload.secondary);
    console.log(payload.palette);
  }
});

The colors function takes an optional second parameter, which are its options:

RGBaster.colors(img, {
  paletteSize: 30,
  exclude: [ 'rgb(255,255,255)' ],  // don't count white
  success: function(payload){
    // do something with payload
  }
})

Browser support

rgbaster.js depends on the following browser functionality:

• Canvas
• CORS
• Array.prototype.map

Check the linked resources above to determine current level of browser support.

Author

Brian Gonzalez

About

RGBaster was created to modularize a feature of another plugin I built called adaptive backgrounds. Check it out.

License

MIT