color-matrix

Description

Apply filters to colors to simulate things like color blindness and night vision. This library tries to simulate the behavior of the svg filter effect feColorMatrix.

It comes in 2 formats: a node.js library and a command line tool.

Examples

Usage and output examples can be found here:

• http://projects.skratchdot.com/color-matrix/examples.html

Node.js Library

Getting Started

Install the module with: npm install color-matrix

var ColorMatrix = require('color-matrix').ColorMatrix;
var matrix = new ColorMatrix();
// simulate color-blindness
matrix.transform([222, 0, 173, 255], 'deuteranopia'); // returns [139, 155, 121, 1]

NOTE: For a better "color blindness" library, see: color-blind. This library is just a port of the old "color matrix" code for use in node. It does allow you to pass in custom filters (which is why I published it, instead of throwing it away).

API Documentation

Read the API Docs by using this link:

• http://projects.skratchdot.com/color-matrix/api.html

Command Line Tool

Installation

The color-matrix tool can be installed globally by running:

npm install -g color-matrix

Usage

  Usage: color-matrix [options] <inputColor>

  Options:

    -h, --help                 output usage information
    -V, --version              output the version number
    -i, --input <imageFile>    input image file
    -o, --output <imageFile>   output image file
    -f, --filter <filterName>  filter name to use
    -v, --value <value>        value for the selected operation type
    -l, --list                 list all the filter names

See Also

• MDN: feColorMatrix
• w3c spec: feColorMatrix
• color-js source code
• Original Color Matrix Library
• StackOverflow: RGB filters for different forms of color blindness
• Fun with the colormatrix

License

Copyright (c) 2014 skratchdot
Licensed under the MIT license.