Colourless

This module limits colors in images. There are features to give maximum colors count or list of color codes.

Currently supports: .jpg

LIVE DEMO

🌐 colourless-js.web.app

Installing

Just install using NPM

npm install --save colourless

Getting Started

Below there are examples how to use this module in different ways:

Example 1: Limit colors count

const Colourless = require('colourless');
 
const colourless = new Colourless('images/wolf.jpg');
 
const buffer = await colourless.limitColorsCount({
    allowedColorsCount: 5,
});
 
fs.writeFileSync('images/wolf-5-color.jpg', buffer);
 

Example 2: Choose allowed colors

 
let buffer;
 
// pass rgb array
 
buffer = await colourless.setColors({
    colors: [
              [0,0,0], // Black RGB
              [255,0,0], // Red RGB
              [255,255,255], // White RGB
            ]
});
 
// OR pass hex values
 
buffer = await colourless.setColors({
    colors: [
              ['#000000'], // Black HEX
              ['#ff0000'], // Red HEX
              ['#ffffff'], // White HEX
            ]
});
 

Example 3: Different input types

const Colourless = require('colourless');
 
let colourless;
 
// Image file path 
colourless= new Colourless('images/wolf.jpg');
 
// base64 input
colourless= new Colourless('data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEBLAE...');
 
// buffer as an imput
colourless= new Colourless(imageBuffer);
 

API

Colourless([path|base64|buffer])

• .limitColorsCount(options)

  • options.allowedColorsCount number of allowed colors (min: 2)

  returns buffer of modified image

• .setColors(options)

  • options.colors array of allowed colors in RGB or HEX formats (min: 2)

  returns buffer of modified image

License

This project is licensed under the MIT License - see the LICENSE file for details