Package Exports

imageoptim

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 (imageoptim) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

image-optim

Node.js wrapper for some images compression algorithms.

Types

PNG – PNGOUT, Zopflipng, Pngcrush, AdvPng and OptiPNG.

Supporting of other types of images are coming soon.

Patches

You can view all the patches which are applied to the algorithms here.

Overview:

optipng.patch – adds to OptiPNG the ability to remove RGB components or transparent pixels in RGB+alpha images.
zopflipng.patch – makes Zopflipng work on Linux.

Install

$ npm install imageoptim

This command will install image-optim and all supported compression algorithms automatically. The installation of the compression algorithms is subscribed in script env-setup.

Usage

API

var imageOptim = require('imageoptim');

imageOptim.optim

Optimizes the given files.

@param {Array} – a list of paths to files to optimize
@param {Object} – options:

reporters {Array} - reporters of the results. flat - writes the results to stdout, html - creats the HTML report of the results in file imageoptim-report.html.

@returns {Promise * Array} – the information about optimized files:

[{ name: 'file.ext', savedBytes: 12345, exitCode: 0 }]

imageOptim.lint

Checks whether the given files can be optimized further.

@param {Array} – a list of paths to files to check
@param {Object} – options:

tolerance {Number} – sets the measurement error in percentages. The file will be considered to be optimized if the percentage of saved bytes after the compression is less than the specified value.
reporters {Array} - reporters of the results. flat - writes the results to stdout, html - creats the HTML report of the results in file imageoptim-report.html.

@returns {Promise * Array} – the information about linted files:

[{ name: 'file.ext', isOptimized: false, exitCode: 0 }]

imageOptim.SUCCESS

If the file was processed without errors its exit code will be equal to 0.

imageOptim.CANT_COMPRESS

If the file can not be compressed its exit code will be equal to 1.

imageOptim.DOESNT_EXIST

If the file does not exist its exit code will be equal to 2.

CLI

$ imageoptim --help
Node.js wrapper for some images compression algorithms

Usage:
  imageoptim [OPTIONS] [ARGS]

Options:
  -h, --help : Help
  -v, --version : Shows the version number
  -l, --lint : Lint mode
  -t TOLERANCE, --tolerance=TOLERANCE : Sets the measurement error in percentages (default: 0)
  -r REPORTERS, --reporter=REPORTERS : flat or/and html (default: flat)

Arguments:
  FILES : Paths to files (required)