pixel-diff

    1.0.1 • Public • Published

    Pixel-Diff

    A lightweight image comparison tool

    dependencies Status Build Status npm version

    What can it do?

    Pixel-Diff was initially created to compare screenshots and continue the work of BlinkDiff.

    There are three types of image comparisons:

    • Pixel-by-pixel - Used to compare low-frequency images like screenshots from web-sites, making sure that small styling differences trigger.
    • Perceptual - Used to compare image creation applications, for example rendering engines and photo manipulation applications that are taking the human perception into account, ignoring differences a human probably would not see.
    • Context - Used to see if parts of images are missing or are severely distorted, but accepts smaller and/or perceptual differences.

    Installation

    Install this module locally with the following command:

    npm install pixel-diff

    Save to dependencies or dev-dependencies:

    npm install --save pixel-diff
    npm install --save-dev pixel-diff

    Usage

    let diff = new PixelDiff({
        imageAPath: 'path/to/first/image',
        imageBPath: 'path/to/second/image',
     
        thresholdType: BlinkDiff.THRESHOLD_PERCENT,
        threshold: 0.01, // 1% threshold
     
        imageOutputPath: 'path/to/output/image'
    });
     
    diff.run((error, result) => {
       if (error) {
          throw error;
       } else {
          console.log(diff.hasPassed(result.code) ? 'Passed' : 'Failed');
          console.log('Found ' + result.differences + ' differences.');
       }
    });

    Refer to docs for more examples.

    Tests

    Run the tests with the following commands:

    npm test or npm test -- unit

    The code-coverage will be written to the coverage folder in the module root.

    Contributing

    See the contributing guide for more information. In lieu of a formal style guide, take care to maintain the existing coding style. Add tests for any new or changed functionality. Lint and test your code using npm test

    License

    Licensed under the MIT license.

    Copyright (c) 2016 Koola.

    Install

    npm i pixel-diff

    DownloadsWeekly Downloads

    30,005

    Version

    1.0.1

    License

    MIT

    Last publish

    Collaborators

    • koola