diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f9d16b4b..13425f86 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -41,7 +41,6 @@ Any change that modifies the existing public API should be added to the relevant | Release | WIP branch | | ------: | :--------- | -| v0.15.0 | outfit | | v0.16.0 | pencil | | v0.17.0 | quill | diff --git a/README.md b/README.md index 9706847e..2245b9ce 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG and WebP images of varying dimensions. -Resizing an image is typically 4x faster than using the +Resizing an image is typically 4x-5x faster than using the quickest ImageMagick and GraphicsMagick settings. Colour spaces, embedded ICC profiles and alpha transparency channels are all handled correctly. diff --git a/docs/index.md b/docs/index.md index ff954026..3e5a0a0c 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,7 +4,7 @@ The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG and WebP images of varying dimensions. -Resizing an image is typically 4x faster than using the +Resizing an image is typically 4x-5x faster than using the quickest ImageMagick and GraphicsMagick settings. Colour spaces, embedded ICC profiles and alpha transparency channels are all handled correctly. diff --git a/docs/performance.md b/docs/performance.md index 63e90594..309c3b7a 100644 --- a/docs/performance.md +++ b/docs/performance.md @@ -2,42 +2,45 @@ ### Test environment -* AWS EC2 [c4.xlarge](http://aws.amazon.com/ec2/instance-types/#c4) (4x E5-2666 v3 @2.90GHz) -* Amazon Linux 2015.09.1 -* Node.js v5.5.0 +* AWS EC2 [c4.xlarge](http://aws.amazon.com/ec2/instance-types/#c4) (4x E5-2666 v3 @ 2.90GHz) +* Amazon Linux AMI 2016.03.1 (HVM), SSD Volume Type +* Node.js v6.2.0 ### The contenders -* [jimp](https://www.npmjs.com/package/jimp) v0.2.20 - Image processing in pure JavaScript. Bilinear interpolation only. -* [lwip](https://www.npmjs.com/package/lwip) v0.0.8 - Wrapper around CImg, compiles dependencies from source. -* [imagemagick-native](https://www.npmjs.com/package/imagemagick-native) @47c7329 - Wrapper around libmagick++, supports Buffers only. +* [jimp](https://www.npmjs.com/package/jimp) v0.2.24 - Image processing in pure JavaScript. Bilinear interpolation only. +* [lwip](https://www.npmjs.com/package/lwip) v0.0.9 - Wrapper around CImg, compiles dependencies from source. +* [imagemagick-native](https://www.npmjs.com/package/imagemagick-native) v1.9.2 - Wrapper around libmagick++, supports Buffers only. * [imagemagick](https://www.npmjs.com/package/imagemagick) v0.1.3 - Supports filesystem only and "*has been unmaintained for a long time*". -* [gm](https://www.npmjs.com/package/gm) v1.21.0 - Fully featured wrapper around GraphicsMagick's `gm` command line utility. -* sharp v0.13.0 / libvips v8.2.2 - Caching within libvips disabled to ensure a fair comparison. +* [gm](https://www.npmjs.com/package/gm) v1.22.0 - Fully featured wrapper around GraphicsMagick's `gm` command line utility. +* sharp v0.15.0 / libvips v8.3.1 - Caching within libvips disabled to ensure a fair comparison. ### The task -Decompress a 2725x2225 JPEG image, resize to 720x480 using bicubic interpolation (where available), then compress to JPEG. +Decompress a 2725x2225 JPEG image, +resize to 720x480 using Lanczos 3 resampling (where available), +then compress to JPEG. ### Results | Module | Input | Output | Ops/sec | Speed-up | | :----------------- | :----- | :----- | ------: | -------: | -| jimp (bilinear) | file | file | 1.04 | 1.0 | -| jimp (bilinear) | buffer | buffer | 1.07 | 1.0 | -| lwip | file | file | 1.13 | 1.1 | -| lwip | buffer | buffer | 1.13 | 1.1 | -| imagemagick-native | buffer | buffer | 1.65 | 1.6 | -| imagemagick | file | file | 5.02 | 4.8 | -| gm | buffer | buffer | 5.36 | 5.2 | -| gm | file | file | 5.39 | 5.2 | -| sharp | stream | stream | 22.00 | 21.2 | -| sharp | file | file | 22.87 | 22.0 | -| sharp | file | buffer | 23.03 | 22.1 | -| sharp | buffer | file | 23.10 | 22.2 | -| sharp | buffer | buffer | 23.21 | 22.3 | +| jimp (bilinear) | file | file | 0.94 | 1.0 | +| jimp (bilinear) | buffer | buffer | 0.98 | 1.0 | +| lwip | file | file | 1.14 | 1.2 | +| lwip | buffer | buffer | 1.14 | 1.2 | +| imagemagick-native | buffer | buffer | 1.66 | 1.8 | +| imagemagick | file | file | 5.08 | 5.4 | +| gm | buffer | buffer | 5.43 | 5.7 | +| gm | file | file | 5.46 | 5.8 | +| sharp | stream | stream | 26.52 | 28.2 | +| sharp | file | file | 28.16 | 30.0 | +| sharp | file | buffer | 28.27 | 30.1 | +| sharp | buffer | file | 28.42 | 30.2 | +| sharp | buffer | buffer | 28.42 | 30.2 | -Greater performance can be expected with caching enabled (default) and using 8+ core machines. +Greater libvips performance can be expected with caching enabled (default) +and using 8+ core machines, especially those with larger L1/L2 CPU caches. The I/O limits of the relevant (de)compression library will generally determine maximum throughput. diff --git a/test/bench/package.json b/test/bench/package.json index ffd5d00c..311923e5 100644 --- a/test/bench/package.json +++ b/test/bench/package.json @@ -14,7 +14,7 @@ "imagemagick": "^0.1.3", "imagemagick-native": "^1.9.2", "jimp": "^0.2.24", - "lwip": "^0.0.8", + "lwip": "^0.0.9", "semver": "^5.1.0" }, "license": "Apache-2.0",