fast-average-color

A simple library that calculates the average color of images, videos and canvas in browser environment.

Usage no npm install needed!

<script type="module">
  import fastAverageColor from 'https://cdn.skypack.dev/fast-average-color';
</script>

README

Fast Average Color

NPM version NPM Downloads bundlephobia install size

Demo

A simple library that calculates average or dominant color of any images or videos in browser environment.

Features

  • Bet on speed
  • Some algorithms: simple, sqrt (default) and dominant
  • Small bundle size, tree shaking
  • Average color can be obtained from:
    • image
    • string (url of image)
    • video
    • canvas
    • array of numbers, Uint8Array or Uint8ClampedArray
  • Average color can be obtained from specific part of resource
  • Support for transparency (PNG, SVG and other formats)
  • Support for web workers
  • Support for Node.js

Table of contents

Unhandled Rejection (SecurityError): The operation is insecure.

The crossOrigin attribute allows images that are loaded from external origins to be used in canvas like the one they were being loaded from the current origin. Using images without CORS approval taints the canvas. Once a canvas has been tainted, you can no longer pull data back out of the canvas. By loading the canvas from cross origin domain, you are tainting the canvas.

You can prevent this by setting crossorigin="anonymous".

More examples

See code

License

MIT License

Links