Skip to content

darosh/colorgram-js

Repository files navigation

Colorgram Build Status

Color extraction library. In TypeScript/JavaScript. For browser/server.

Demo

test/browser_test.html

Features

  • small size, 1kB (minified + gzipped)
  • pretty fast, 512×512 pixels in ~50ms, 340×340 pixels in ~15ms (~6× slower on mobile)
  • scans every pixel
  • identical output for rotated images
  • sampled by top 2 bits of 3 groups: H, L, and luminance
  • calculates average per group
  • fixed memory footprint, samples using 2 (bits) ^ 3 (groups) * 4 (RGB + count) * 4 (Uint32) = 1024 bytes
  • usually generates small (~16 colors) palette of main colors
  • supports RGB and RGBA input pixel array (compatible with ImageData.data)
  • using TypedArray
  • no native dependencies

Similar stuff

Install

npm install colorgram

Usage

See test folder.

TypeScript documentation

http://darosh.github.io/colorgram-js/doc/

License

MIT