JSPM

  • Created
  • Published
  • Downloads 61032
  • Score
    100M100P100Q144889F
  • License MIT

Image analysis and comparison with HTML5

Package Exports

  • resemblejs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (resemblejs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Resemble.js

Analyse and compare images with Javascript and HTML5. Resemble.js Demo

Two image diff examples side-by-side, one pink, one yellow.

Get it

npm install resemblejs

bower install resemblejs

Example

Retrieve basic analysis on image.

var api = resemble(fileData).onComplete(function(data){
    console.log(data);
    /*
    {
      red: 255,
      green: 255,
      blue: 255,
      brightness: 255
    }
    */
});

Use resemble to compare two images.

var diff = resemble(file).compareTo(file2).ignoreColors().onComplete(function(data){
    console.log(data);
    /*
    {
      misMatchPercentage : 100, // %
      isSameDimensions: true, // or false
      dimensionDifference: { width: 0, height: -1 }, // defined if dimensions are not the same
      getImageDataUrl: function(){}
    }
    */
});

You can also change the comparison method after the first analysis.

// diff.ignoreNothing();
// diff.ignoreColors();
diff.ignoreAntialiasing();

And change the output display style.

resemble.outputSettings({
  errorColor: {
    red: 255,
    green: 0,
    blue: 255
  },
  errorType: 'movement',
  transparency: 0.3,
  largeImageThreshold: 1200
});
// resembleControl.repaint();

By default, the comparison algorithm skips pixels when the image width or height is larger than 1200 pixels. This is there to mitigate performance issues.

You can switch this modify this behaviour by setting the largeImageThreshold option to a different value. Set it to 0 to switch it off completely.


Created by James Cryer and the Huddle development team.