sharp

Package Overview

Dependencies

Maintainers

Versions

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

sharp - npm Package Compare versions

Comparing version 0.20.8 to 0.21.0

docs/api-colour.md

		<!-- Generated by documentation.js. Update this documentation by updating the source code. -->

		## background

		Set the background for the `embed`, `flatten` and `extend` operations.
		The default background is `{r: 0, g: 0, b: 0, alpha: 1}`, black without transparency.

		Delegates to the _color_ module, which can throw an Error
		but is liberal in what it accepts, clipping values to sensible min/max.
		The alpha value is a float between `0` (transparent) and `1` (opaque).

		### Parameters

		- `rgba` ([String][1] \\| [Object][2]) parsed by the [color][3] module to extract values for red, green, blue and alpha.


		- Throws [Error][4] Invalid parameter

		Returns Sharp

		## tint
		@@ -97,2 +79,2 @@

		[6]: https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/enumtypes.c#L568
		[6]: https://github.com/libvips/libvips/blob/master/libvips/iofuncs/enumtypes.c#L568

docs/api-input.md

		@@ -28,2 +28,3 @@ <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
		- `format`: Name of decoder used to decompress image data e.g. `jpeg`, `png`, `webp`, `gif`, `svg`
		- `size`: Total size of image in bytes, for Stream and Buffer input only
		- `width`: Number of pixels wide (EXIF orientation is not taken into consideration)
		@@ -35,2 +36,4 @@ - `height`: Number of pixels high (EXIF orientation is not taken into consideration)
		- `density`: Number of pixels per inch (DPI), if present
		- `chromaSubsampling`: String containing JPEG chroma subsampling, `4:2:0` or `4:4:4` for RGB, `4:2:0:4` or `4:4:4:4` for CMYK
		- `isProgressive`: Boolean indicating whether the image is interlaced using a progressive scan
		- `hasProfile`: Boolean indicating the presence of an embedded ICC profile
		@@ -131,5 +134,5 @@ - `hasAlpha`: Boolean indicating the presence of an alpha transparency channel

		[1]: https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/enumtypes.c#L636
		[1]: https://github.com/libvips/libvips/blob/master/libvips/iofuncs/enumtypes.c#L636

		[2]: https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/enumtypes.c#L672
		[2]: https://github.com/libvips/libvips/blob/master/libvips/iofuncs/enumtypes.c#L672

		@@ -136,0 +139,0 @@ [3]: https://www.npmjs.com/package/icc

155

docs/api-operation.md

		@@ -8,5 +8,8 @@ <!-- Generated by documentation.js. Update this documentation by updating the source code. -->

		If an angle is provided, it is converted to a valid 90/180/270deg rotation.
		If an angle is provided, it is converted to a valid positive degree rotation.
		For example, `-450` will produce a 270deg rotation.

		When rotating by an angle other than a multiple of 90,
		the background colour can be provided with the `background` option.

		If no angle is provided, it is determined from the EXIF data.
		@@ -22,3 +25,5 @@ Mirroring is supported and may infer the use of a flip operation.

		- `angle` [Number][1] angle of rotation, must be a multiple of 90. (optional, default `auto`)
		- `angle` [Number][1] angle of rotation. (optional, default `auto`)
		- `options` [Object][2]? if present, is an Object with optional attributes.
		- `options.background` ([String][3] \\| [Object][2]) parsed by the [color][4] module to extract values for red, green, blue and alpha. (optional, default `"#000000"`)

		@@ -39,46 +44,6 @@ ### Examples

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		Returns Sharp

		## extract

		Extract a region of the image.

		- Use `extract` before `resize` for pre-resize extraction.
		- Use `extract` after `resize` for post-resize extraction.
		- Use `extract` before and after for both.

		### Parameters

		- `options` [Object][3]
		- `options.left` [Number][1] zero-indexed offset from left edge
		- `options.top` [Number][1] zero-indexed offset from top edge
		- `options.width` [Number][1] dimension of extracted image
		- `options.height` [Number][1] dimension of extracted image

		### Examples

		```javascript
		sharp(input)
		.extract({ left: left, top: top, width: width, height: height })
		.toFile(output, function(err) {
		// Extract a region of the input image, saving in the same format.
		});
		```

		```javascript
		sharp(input)
		.extract({ left: leftOffsetPre, top: topOffsetPre, width: widthPre, height: heightPre })
		.resize(width, height)
		.extract({ left: leftOffsetPost, top: topOffsetPost, width: widthPost, height: heightPost })
		.toFile(output, function(err) {
		// Extract a region, resize, then extract from the resized image
		});
		```

		- Throws [Error][2] Invalid parameters

		Returns Sharp

		## flip
		@@ -91,3 +56,3 @@

		- `flip` [Boolean][4] (optional, default `true`)
		- `flip` [Boolean][6] (optional, default `true`)

		@@ -103,3 +68,3 @@ Returns Sharp

		- `flop` [Boolean][4] (optional, default `true`)
		- `flop` [Boolean][6] (optional, default `true`)

		@@ -122,3 +87,3 @@ Returns Sharp

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -137,3 +102,3 @@ Returns Sharp

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -153,58 +118,16 @@ Returns Sharp

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		Returns Sharp

		## extend

		Extends/pads the edges of the image with the colour provided to the `background` method.
		This operation will always occur after resizing and extraction, if any.

		### Parameters

		- `extend` ([Number][1] \\| [Object][3]) single pixel count to add to all edges or an Object with per-edge counts
		- `extend.top` [Number][1]?
		- `extend.left` [Number][1]?
		- `extend.bottom` [Number][1]?
		- `extend.right` [Number][1]?

		### Examples

		```javascript
		// Resize to 140 pixels wide, then add 10 transparent pixels
		// to the top, left and right edges and 20 to the bottom edge
		sharp(input)
		.resize(140)
		.background({r: 0, g: 0, b: 0, alpha: 0})
		.extend({top: 10, bottom: 20, left: 10, right: 10})
		...
		```

		- Throws [Error][2] Invalid parameters

		Returns Sharp

		## flatten

		Merge alpha transparency channel, if any, with `background`.
		Merge alpha transparency channel, if any, with a background.

		### Parameters

		- `flatten` [Boolean][4] (optional, default `true`)
		- `options`

		Returns Sharp

		## trim

		Trim "boring" pixels from all edges that contain values within a percentage similarity of the top-left pixel.

		### Parameters

		- `tolerance` [Number][1] value between 1 and 99 representing the percentage similarity. (optional, default `10`)


		- Throws [Error][2] Invalid parameters

		Returns Sharp

		## gamma
		@@ -223,3 +146,3 @@

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -234,3 +157,3 @@ Returns Sharp

		- `negate` [Boolean][4] (optional, default `true`)
		- `negate` [Boolean][6] (optional, default `true`)

		@@ -245,3 +168,3 @@ Returns Sharp

		- `normalise` [Boolean][4] (optional, default `true`)
		- `normalise` [Boolean][6] (optional, default `true`)

		@@ -256,3 +179,3 @@ Returns Sharp

		- `normalize` [Boolean][4] (optional, default `true`)
		- `normalize` [Boolean][6] (optional, default `true`)

		@@ -267,6 +190,6 @@ Returns Sharp

		- `kernel` [Object][3]
		- `kernel` [Object][2]
		- `kernel.width` [Number][1] width of the kernel in pixels.
		- `kernel.height` [Number][1] width of the kernel in pixels.
		- `kernel.kernel` [Array][5]<[Number][1]> Array of length `width*height` containing the kernel values.
		- `kernel.kernel` [Array][7]<[Number][1]> Array of length `width*height` containing the kernel values.
		- `kernel.scale` [Number][1] the scale of the kernel in pixels. (optional, default `sum`)
		@@ -291,3 +214,3 @@ - `kernel.offset` [Number][1] the offset of the kernel in pixels. (optional, default `0`)

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -303,8 +226,8 @@ Returns Sharp
		- `threshold` [Number][1] a value in the range 0-255 representing the level at which the threshold will be applied. (optional, default `128`)
		- `options` [Object][3]?
		- `options.greyscale` [Boolean][4] convert to single channel greyscale. (optional, default `true`)
		- `options.grayscale` [Boolean][4] alternative spelling for greyscale. (optional, default `true`)
		- `options` [Object][2]?
		- `options.greyscale` [Boolean][6] convert to single channel greyscale. (optional, default `true`)
		- `options.grayscale` [Boolean][6] alternative spelling for greyscale. (optional, default `true`)


		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -322,6 +245,6 @@ Returns Sharp

		- `operand` ([Buffer][6] \\| [String][7]) Buffer containing image data or String containing the path to an image file.
		- `operator` [String][7] one of `and`, `or` or `eor` to perform that bitwise operation, like the C logic operators `&`, `\|` and `^` respectively.
		- `options` [Object][3]?
		- `options.raw` [Object][3]? describes operand when using raw pixel data.
		- `operand` ([Buffer][8] \\| [String][3]) Buffer containing image data or String containing the path to an image file.
		- `operator` [String][3] one of `and`, `or` or `eor` to perform that bitwise operation, like the C logic operators `&`, `\|` and `^` respectively.
		- `options` [Object][2]?
		- `options.raw` [Object][2]? describes operand when using raw pixel data.
		- `options.raw.width` [Number][1]?
		@@ -332,3 +255,3 @@ - `options.raw.height` [Number][1]?

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -347,3 +270,3 @@ Returns Sharp

		- Throws [Error][2] Invalid parameters
		- Throws [Error][5] Invalid parameters

		@@ -354,12 +277,14 @@ Returns Sharp

		[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error
		[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object

		[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
		[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String

		[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
		[4]: https://www.npmjs.org/package/color

		[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
		[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error

		[6]: https://nodejs.org/api/buffer.html
		[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean

		[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
		[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array

		[8]: https://nodejs.org/api/buffer.html

268

docs/api-resize.md

		@@ -5,10 +5,31 @@ <!-- Generated by documentation.js. Update this documentation by updating the source code. -->

		Resize image to `width` x `height`.
		By default, the resized image is centre cropped to the exact size specified.
		Resize image to `width`, `height` or `width x height`.

		Possible kernels are:
		When both a `width` and `height` are provided, the possible methods by which the image should fit these are:

		- `nearest`: Use [nearest neighbour interpolation][1].
		- `cubic`: Use a [Catmull-Rom spline][2].
		- `lanczos2`: Use a [Lanczos kernel][3] with `a=2`.
		- `cover`: Crop to cover both provided dimensions (the default).
		- `contain`: Embed within both provided dimensions.
		- `fill`: Ignore the aspect ratio of the input and stretch to both provided dimensions.
		- `inside`: Preserving aspect ratio, resize the image to be as large as possible while ensuring its dimensions are less than or equal to both those specified.
		- `outside`: Preserving aspect ratio, resize the image to be as small as possible while ensuring its dimensions are greater than or equal to both those specified.
		Some of these values are based on the [object-fit][1] CSS property.

		When using a `fit` of `cover` or `contain`, the default position is `centre`. Other options are:

		- `sharp.position`: `top`, `right top`, `right`, `right bottom`, `bottom`, `left bottom`, `left`, `left top`.
		- `sharp.gravity`: `north`, `northeast`, `east`, `southeast`, `south`, `southwest`, `west`, `northwest`, `center` or `centre`.
		- `sharp.strategy`: `cover` only, dynamically crop using either the `entropy` or `attention` strategy.
		Some of these values are based on the [object-position][2] CSS property.

		The experimental strategy-based approach resizes so one dimension is at its target length
		then repeatedly ranks edge regions, discarding the edge with the lowest score based on the selected strategy.

		- `entropy`: focus on the region with the highest [Shannon entropy][3].
		- `attention`: focus on the region with the highest luminance frequency, colour saturation and presence of skin tones.

		Possible interpolation kernels are:

		- `nearest`: Use [nearest neighbour interpolation][4].
		- `cubic`: Use a [Catmull-Rom spline][5].
		- `lanczos2`: Use a [Lanczos kernel][6] with `a=2`.
		- `lanczos3`: Use a Lanczos kernel with `a=3` (the default).
		@@ -18,7 +39,13 @@

		- `width` [Number][4]? pixels wide the resultant image should be. Use `null` or `undefined` to auto-scale the width to match the height.
		- `height` [Number][4]? pixels high the resultant image should be. Use `null` or `undefined` to auto-scale the height to match the width.
		- `options` [Object][5]?
		- `options.kernel` [String][6] the kernel to use for image reduction. (optional, default `'lanczos3'`)
		- `options.fastShrinkOnLoad` [Boolean][7] take greater advantage of the JPEG and WebP shrink-on-load feature, which can lead to a slight moiré pattern on some images. (optional, default `true`)
		- `width` [Number][7]? pixels wide the resultant image should be. Use `null` or `undefined` to auto-scale the width to match the height.
		- `height` [Number][7]? pixels high the resultant image should be. Use `null` or `undefined` to auto-scale the height to match the width.
		- `options` [Object][8]?
		- `options.width` [String][9]? alternative means of specifying `width`. If both are present this take priority.
		- `options.height` [String][9]? alternative means of specifying `height`. If both are present this take priority.
		- `options.fit` [String][9] how the image should be resized to fit both provided dimensions, one of `cover`, `contain`, `fill`, `inside` or `outside`. (optional, default `'cover'`)
		- `options.position` [String][9] position, gravity or strategy to use when `fit` is `cover` or `contain`. (optional, default `'centre'`)
		- `options.background` ([String][9] \\| [Object][8]) background colour when using a `fit` of `contain`, parsed by the [color][10] module, defaults to black without transparency. (optional, default `{r:0,g:0,b:0,alpha:1}`)
		- `options.kernel` [String][9] the kernel to use for image reduction. (optional, default `'lanczos3'`)
		- `options.withoutEnlargement` [Boolean][11] do not enlarge if the width _or_ height are already less than the specified dimensions, equivalent to GraphicsMagick's `>` geometry option. (optional, default `false`)
		- `options.fastShrinkOnLoad` [Boolean][11] take greater advantage of the JPEG and WebP shrink-on-load feature, which can lead to a slight moiré pattern on some images. (optional, default `true`)

		@@ -28,36 +55,82 @@ ### Examples
		```javascript
		sharp(inputBuffer)
		sharp(input)
		.resize({ width: 100 })
		.toBuffer()
		.then(data => {
		// 100 pixels wide, auto-scaled height
		});
		```

		```javascript
		sharp(input)
		.resize({ height: 100 })
		.toBuffer()
		.then(data => {
		// 100 pixels high, auto-scaled width
		});
		```

		```javascript
		sharp(input)
		.resize(200, 300, {
		kernel: sharp.kernel.nearest
		kernel: sharp.kernel.nearest,
		fit: 'contain',
		position: 'right top',
		background: { r: 255, g: 255, b: 255, alpha: 0.5 }
		})
		.background('white')
		.embed()
		.toFile('output.tiff')
		.then(function() {
		// output.tiff is a 200 pixels wide and 300 pixels high image
		// containing a nearest-neighbour scaled version, embedded on a white canvas,
		// of the image data in inputBuffer
		.toFile('output.png')
		.then(() => {
		// output.png is a 200 pixels wide and 300 pixels high image
		// containing a nearest-neighbour scaled version
		// contained within the north-east corner of a semi-transparent white canvas
		});
		```

		- Throws [Error][8] Invalid parameters
		```javascript
		const transformer = sharp()
		.resize({
		width: 200,
		height: 200,
		fit: sharp.fit.cover,
		position: sharp.strategy.entropy
		});
		// Read image data from readableStream
		// Write 200px square auto-cropped image data to writableStream
		readableStream
		.pipe(transformer)
		.pipe(writableStream);
		```

		Returns Sharp
		```javascript
		sharp(input)
		.resize(200, 200, {
		fit: sharp.fit.inside,
		withoutEnlargement: true
		})
		.toFormat('jpeg')
		.toBuffer()
		.then(function(outputBuffer) {
		// outputBuffer contains JPEG image data
		// no wider and no higher than 200 pixels
		// and no larger than the input image
		});
		```

		## crop
		- Throws [Error][12] Invalid parameters

		Crop the resized image to the exact size specified, the default behaviour.
		Returns Sharp

		Possible attributes of the optional `sharp.gravity` are `north`, `northeast`, `east`, `southeast`, `south`,
		`southwest`, `west`, `northwest`, `center` and `centre`.
		## extend

		The experimental strategy-based approach resizes so one dimension is at its target length
		then repeatedly ranks edge regions, discarding the edge with the lowest score based on the selected strategy.
		Extends/pads the edges of the image with the provided background colour.
		This operation will always occur after resizing and extraction, if any.

		- `entropy`: focus on the region with the highest [Shannon entropy][9].
		- `attention`: focus on the region with the highest luminance frequency, colour saturation and presence of skin tones.

		### Parameters

		- `crop` [String][6] A member of `sharp.gravity` to crop to an edge/corner or `sharp.strategy` to crop dynamically. (optional, default `'centre'`)
		- `extend` ([Number][7] \\| [Object][8]) single pixel count to add to all edges or an Object with per-edge counts
		- `extend.top` [Number][7]?
		- `extend.left` [Number][7]?
		- `extend.bottom` [Number][7]?
		- `extend.right` [Number][7]?
		- `extend.background` ([String][9] \\| [Object][8]) background colour, parsed by the [color][10] module, defaults to black without transparency. (optional, default `{r:0,g:0,b:0,alpha:1}`)

		@@ -67,28 +140,36 @@ ### Examples
		```javascript
		const transformer = sharp()
		.resize(200, 200)
		.crop(sharp.strategy.entropy)
		.on('error', function(err) {
		console.log(err);
		});
		// Read image data from readableStream
		// Write 200px square auto-cropped image data to writableStream
		readableStream.pipe(transformer).pipe(writableStream);
		// Resize to 140 pixels wide, then add 10 transparent pixels
		// to the top, left and right edges and 20 to the bottom edge
		sharp(input)
		.resize(140)
		.)
		.extend({
		top: 10,
		bottom: 20,
		left: 10,
		right: 10
		background: { r: 0, g: 0, b: 0, alpha: 0 }
		})
		...
		```

		- Throws [Error][8] Invalid parameters
		- Throws [Error][12] Invalid parameters

		Returns Sharp

		## embed
		## extract

		Preserving aspect ratio, resize the image to the maximum `width` or `height` specified
		then embed on a background of the exact `width` and `height` specified.
		Extract a region of the image.

		If the background contains an alpha value then WebP and PNG format output images will
		contain an alpha channel, even when the input image does not.
		- Use `extract` before `resize` for pre-resize extraction.
		- Use `extract` after `resize` for post-resize extraction.
		- Use `extract` before and after for both.

		### Parameters

		- `embed` [String][6] A member of `sharp.gravity` to embed to an edge/corner. (optional, default `'centre'`)
		- `options` [Object][8]
		- `options.left` [Number][7] zero-indexed offset from left edge
		- `options.top` [Number][7] zero-indexed offset from top edge
		- `options.width` [Number][7] dimension of extracted image
		- `options.height` [Number][7] dimension of extracted image

		@@ -98,90 +179,59 @@ ### Examples
		```javascript
		sharp('input.gif')
		.resize(200, 300)
		.background({r: 0, g: 0, b: 0, alpha: 0})
		.embed()
		.toFormat(sharp.format.webp)
		.toBuffer(function(err, outputBuffer) {
		if (err) {
		throw err;
		}
		// outputBuffer contains WebP image data of a 200 pixels wide and 300 pixels high
		// containing a scaled version, embedded on a transparent canvas, of input.gif
		sharp(input)
		.extract({ left: left, top: top, width: width, height: height })
		.toFile(output, function(err) {
		// Extract a region of the input image, saving in the same format.
		});
		```

		- Throws [Error][8] Invalid parameters

		Returns Sharp

		## max

		Preserving aspect ratio, resize the image to be as large as possible
		while ensuring its dimensions are less than or equal to the `width` and `height` specified.

		Both `width` and `height` must be provided via `resize` otherwise the behaviour will default to `crop`.

		### Examples

		```javascript
		sharp(inputBuffer)
		.resize(200, 200)
		.max()
		.toFormat('jpeg')
		.toBuffer()
		.then(function(outputBuffer) {
		// outputBuffer contains JPEG image data no wider than 200 pixels and no higher
		// than 200 pixels regardless of the inputBuffer image dimensions
		sharp(input)
		.extract({ left: leftOffsetPre, top: topOffsetPre, width: widthPre, height: heightPre })
		.resize(width, height)
		.extract({ left: leftOffsetPost, top: topOffsetPost, width: widthPost, height: heightPost })
		.toFile(output, function(err) {
		// Extract a region, resize, then extract from the resized image
		});
		```

		- Throws [Error][12] Invalid parameters

		Returns Sharp

		## min
		## trim

		Preserving aspect ratio, resize the image to be as small as possible
		while ensuring its dimensions are greater than or equal to the `width` and `height` specified.
		Trim "boring" pixels from all edges that contain values similar to the top-left pixel.
		The `info` response Object will contain `trimOffsetLeft` and `trimOffsetTop` properties.

		Both `width` and `height` must be provided via `resize` otherwise the behaviour will default to `crop`.
		### Parameters

		Returns Sharp
		- `threshold` [Number][7] the allowed difference from the top-left pixel, a number greater than zero. (optional, default `10`)

		## ignoreAspectRatio

		Ignoring the aspect ratio of the input, stretch the image to
		the exact `width` and/or `height` provided via `resize`.
		- Throws [Error][12] Invalid parameters

		Returns Sharp

		## withoutEnlargement
		[1]: https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit

		Do not enlarge the output image if the input image width _or_ height are already less than the required dimensions.
		This is equivalent to GraphicsMagick's `>` geometry option:
		"_change the dimensions of the image only if its width or height exceeds the geometry specification_".
		Use with `max()` to preserve the image's aspect ratio.
		[2]: https://developer.mozilla.org/en-US/docs/Web/CSS/object-position

		The default behaviour _before_ function call is `false`, meaning the image will be enlarged.
		[3]: https://en.wikipedia.org/wiki/Entropy_%28information_theory%29

		### Parameters
		[4]: http://en.wikipedia.org/wiki/Nearest-neighbor_interpolation

		- `withoutEnlargement` [Boolean][7] (optional, default `true`)
		[5]: https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline

		Returns Sharp
		[6]: https://en.wikipedia.org/wiki/Lanczos_resampling#Lanczos_kernel

		[1]: http://en.wikipedia.org/wiki/Nearest-neighbor_interpolation
		[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number

		[2]: https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline
		[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object

		[3]: https://en.wikipedia.org/wiki/Lanczos_resampling#Lanczos_kernel
		[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String

		[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
		[10]: https://www.npmjs.org/package/color

		[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
		[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean

		[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String

		[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean

		[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error

		[9]: https://en.wikipedia.org/wiki/Entropy_%28information_theory%29
		[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error

docs/api-utility.md

		@@ -80,8 +80,5 @@ <!-- Generated by documentation.js. Update this documentation by updating the source code. -->

		This feature is currently off by default but future versions may reverse this.
		Versions of liborc prior to 0.4.25 are known to segfault under heavy load.

		### Parameters

		- `simd` [Boolean][2] (optional, default `false`)
		- `simd` [Boolean][2] (optional, default `true`)

		@@ -92,8 +89,8 @@ ### Examples
		const simd = sharp.simd();
		// simd is `true` if SIMD is currently enabled
		// simd is `true` if the runtime use of liborc is currently enabled
		```

		```javascript
		const simd = sharp.simd(true);
		// attempts to enable the use of SIMD, returning true if available
		const simd = sharp.simd(false);
		// prevent libvips from using liborc at runtime
		```
		@@ -100,0 +97,0 @@

docs/changelog.md

		# Changelog

		### v0.21 - "teeth"

		Requires libvips v8.7.0.

		#### v0.21.0 - 4<sup>th</sup> October 2018

		* Deprecate the following resize-related functions:
		`crop`, `embed`, `ignoreAspectRatio`, `max`, `min` and `withoutEnlargement`.
		Access to these is now via options passed to the `resize` function.
		For example:
		`embed('north')` is now `resize(width, height, { fit: 'contain', position: 'north' })`,
		`crop('attention')` is now `resize(width, height, { fit: 'cover', position: 'attention' })`,
		`max().withoutEnlargement()` is now `resize(width, height, { fit: 'inside', withoutEnlargement: true })`.
		[#1135](https://github.com/lovell/sharp/issues/1135)

		* Deprecate the `background` function.
		Per-operation `background` options added to `resize`, `extend` and `flatten` operations.
		[#1392](https://github.com/lovell/sharp/issues/1392)

		* Add `size` to `metadata` response (Stream and Buffer input only).
		[#695](https://github.com/lovell/sharp/issues/695)

		* Switch from custom trim operation to `vips_find_trim`.
		[#914](https://github.com/lovell/sharp/issues/914)

		* Add `chromaSubsampling` and `isProgressive` properties to `metadata` response.
		[#1186](https://github.com/lovell/sharp/issues/1186)

		* Drop Node 4 support.
		[#1212](https://github.com/lovell/sharp/issues/1212)

		* Enable SIMD convolution by default.
		[#1213](https://github.com/lovell/sharp/issues/1213)

		* Add experimental prebuilt binaries for musl-based Linux.
		[#1379](https://github.com/lovell/sharp/issues/1379)

		* Add support for arbitrary rotation angle via vips_rotate.
		[#1385](https://github.com/lovell/sharp/pull/1385)
		[@freezy](https://github.com/freezy)

		### v0.20 - "prebuild"
		@@ -4,0 +45,0 @@

docs/index.md

		@@ -16,4 +16,4 @@ # sharp

		Most 64-bit OS X, Windows and Linux (glibc) systems running
		Node versions 4, 6, 8 and 10
		Most modern 64-bit OS X, Windows and Linux systems running
		Node versions 6, 8 and 10
		do not require any additional install or runtime dependencies.
		@@ -41,3 +41,3 @@
		This module is powered by the blazingly fast
		[libvips](https://github.com/jcupitt/libvips) image processing library,
		[libvips](https://github.com/libvips/libvips) image processing library,
		originally created in 1989 at Birkbeck College
		@@ -123,6 +123,7 @@ and currently maintained by
		* [Axel Eirola](https://github.com/aeirola)
		* [Freezy](https://github.com/freezy)

		Thank you!

		### Licence
		### Licensing

		@@ -129,0 +130,0 @@ Copyright 2013, 2014, 2015, 2016, 2017, 2018 Lovell Fuller and contributors.

docs/install.md

		@@ -18,3 +18,3 @@ # Installation
		Pre-compiled binaries for sharp are provided for use with
		Node versions 4, 6, 8 and 10 on
		Node versions 6, 8 and 10 on
		64-bit Windows, OS X and Linux platforms.
		@@ -31,3 +31,3 @@
		* C++11 compatible compiler such as gcc 4.8+, clang 3.0+ or MSVC 2013+
		* [node-gyp](https://github.com/TooTallNate/node-gyp#installation) and its dependencies (includes Python)
		* [node-gyp](https://github.com/nodejs/node-gyp#installation) and its dependencies (includes Python 2.7)

		@@ -41,5 +41,5 @@ ## libvips
		libvips and its dependencies are fetched and stored within `node_modules/sharp/vendor` during `npm install`.
		This involves an automated HTTPS download of approximately 7MB.
		This involves an automated HTTPS download of approximately 8MB.

		Most recent Linux-based operating systems with glibc running on x64 and ARMv6+ CPUs should "just work", e.g.:
		Most Linux-based (glibc, musl) operating systems running on x64 and ARMv6+ CPUs should "just work", e.g.:

		@@ -49,2 +49,3 @@ * Debian 7+
		* Centos 7+
		* Alpine 3.8+ (Node 8 and 10)
		* Fedora
		@@ -68,5 +69,5 @@ * openSUSE 13.2+
		For 32-bit Intel CPUs and older Linux-based operating systems such as Centos 6,
		it is recommended to install a system-wide installation of libvips from source:
		compiling libvips from source is recommended.

		https://jcupitt.github.io/libvips/install.html#building-libvips-from-a-source-tarball
		[https://libvips.github.io/libvips/install.html#building-libvips-from-a-source-tarball](https://libvips.github.io/libvips/install.html#building-libvips-from-a-source-tarball)

		@@ -79,3 +80,3 @@ #### Alpine Linux
		```sh
		apk add vips-dev fftw-dev --update-cache --repository https://dl-3.alpinelinux.org/alpine/edge/testing/
		apk add vips-dev fftw-dev build-base --update-cache --repository https://dl-3.alpinelinux.org/alpine/edge/testing/
		```
		@@ -103,3 +104,3 @@
		libvips and its dependencies are fetched and stored within `node_modules\sharp\vendor` during `npm install`.
		This involves an automated HTTPS download of approximately 12MB.
		This involves an automated HTTPS download of approximately 13MB.

		@@ -127,5 +128,2 @@ Only 64-bit (x64) `node.exe` is supported.

		libvips and its dependencies are fetched and stored within `node_modules\sharp\vendor` during `npm install`.
		This involves an automated HTTPS download of approximately 7MB.

		Set [NODE_MODULES_CACHE](https://devcenter.heroku.com/articles/nodejs-support#cache-behavior)
		@@ -165,8 +163,9 @@ to `false` when using the `yarn` package manager.
		rm -rf node_modules/sharp
		docker run -v "$PWD":/var/task lambci/lambda:build-nodejs6.10 npm install
		docker run -v "$PWD":/var/task lambci/lambda:build-nodejs8.10 npm install
		```

		Set the Lambda runtime to Node.js 6.10.
		Set the Lambda runtime to Node.js 8.10.

		To get the best performance select the largest memory available. A 1536 MB function provides ~12x more CPU time than a 128 MB function.
		To get the best performance select the largest memory available.
		A 1536 MB function provides ~12x more CPU time than a 128 MB function.

		@@ -183,3 +182,3 @@ ### NW.js

		See also http://docs.nwjs.io/en/latest/For%20Users/Advanced/Use%20Native%20Node%20Modules/
		[http://docs.nwjs.io/en/latest/For%20Users/Advanced/Use%20Native%20Node%20Modules/](http://docs.nwjs.io/en/latest/For%20Users/Advanced/Use%20Native%20Node%20Modules/)

		@@ -212,24 +211,2 @@ ### Build tools

		ImageMagick in particular has a relatively large attack surface,
		which can be partially mitigated with a
		[policy.xml](http://www.imagemagick.org/script/resources.php)
		configuration file to prevent the use of coders known to be vulnerable.

		```xml
		<policymap>
		<policy domain="coder" rights="none" pattern="EPHEMERAL" />
		<policy domain="coder" rights="none" pattern="URL" />
		<policy domain="coder" rights="none" pattern="HTTPS" />
		<policy domain="coder" rights="none" pattern="MVG" />
		<policy domain="coder" rights="none" pattern="MSL" />
		<policy domain="coder" rights="none" pattern="TEXT" />
		<policy domain="coder" rights="none" pattern="SHOW" />
		<policy domain="coder" rights="none" pattern="WIN" />
		<policy domain="coder" rights="none" pattern="PLT" />
		</policymap>
		```

		Set the `MAGICK_CONFIGURE_PATH` environment variable
		to the directory containing the `policy.xml` file.

		### Pre-compiled libvips binaries
		@@ -250,3 +227,4 @@
		Should you need to manually download and inspect these files,
		you can do so via https://github.com/lovell/sharp-libvips/releases
		you can do so via
		[https://github.com/lovell/sharp-libvips/releases](https://github.com/lovell/sharp-libvips/releases)

		@@ -280,2 +258,4 @@ Should you wish to install these from your own location,
		\| freetype \| [freetype Licence](http://git.savannah.gnu.org/cgit/freetype/freetype2.git/tree/docs/FTL.TXT) (BSD-like) \|
		\| fribidi \| LGPLv3 \|
		\| gettext \| LGPLv3 \|
		\| giflib \| MIT Licence \|
		@@ -282,0 +262,0 @@ \| glib \| LGPLv3 \|

docs/performance.md

		@@ -6,15 +6,13 @@ # Performance
		* AWS EC2 eu-west-1 [c5.large](https://aws.amazon.com/ec2/instance-types/c5/) (2x Xeon Platinum 8124M CPU @ 3.00GHz)
		* Ubuntu 17.10 (hvm:ebs-ssd, 20180102, ami-0741d47e)
		* Node.js v8.9.4
		* Ubuntu 18.04 (hvm-ssd/ubuntu-bionic-18.04-amd64-server-20180912 ami-00035f41c82244dab)
		* Node.js v10.11.0

		### The contenders

		* [jimp](https://www.npmjs.com/package/jimp) v0.2.28 - Image processing in pure JavaScript. Bilinear interpolation only.
		* [pajk-lwip](https://www.npmjs.com/package/pajk-lwip) v0.2.0 (fork) - Wrapper around CImg that compiles dependencies from source.
		* [mapnik](https://www.npmjs.org/package/mapnik) v3.6.2 - Whilst primarily a map renderer, Mapnik contains bitmap image utilities.
		* [jimp](https://www.npmjs.com/package/jimp) v0.5.3 - Image processing in pure JavaScript. Provides bicubic interpolation.
		* [mapnik](https://www.npmjs.org/package/mapnik) v4.0.1 - Whilst primarily a map renderer, Mapnik contains bitmap image utilities.
		* [imagemagick-native](https://www.npmjs.com/package/imagemagick-native) v1.9.3 - 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.23.1 - Fully featured wrapper around GraphicsMagick's `gm` command line utility.
		* [images](https://www.npmjs.com/package/images) v3.0.1 - Compiles dependencies from source. Provides bicubic interpolation.
		* sharp v0.19.0 / libvips v8.6.1 - Caching within libvips disabled to ensure a fair comparison.
		* sharp v0.21.0 / libvips v8.7.0 - Caching within libvips disabled to ensure a fair comparison.

		@@ -31,15 +29,10 @@ ### The task
		\| :----------------- \| :----- \| :----- \| ------: \| -------: \|
		\| jimp (bilinear) \| buffer \| buffer \| 1.14 \| 1.0 \|
		\| lwip \| buffer \| buffer \| 1.86 \| 1.6 \|
		\| mapnik \| buffer \| buffer \| 3.34 \| 2.9 \|
		\| imagemagick-native \| buffer \| buffer \| 4.13 \| 3.6 \|
		\| gm \| buffer \| buffer \| 4.21 \| 3.7 \|
		\| gm \| file \| file \| 4.27 \| 3.7 \|
		\| imagemagick \| file \| file \| 4.67 \| 4.1 \|
		\| images (bicubic) \| file \| file \| 6.22 \| 5.5 \|
		\| sharp \| stream \| stream \| 24.43 \| 21.4 \|
		\| sharp \| file \| file \| 25.97 \| 22.7 \|
		\| sharp \| file \| buffer \| 26.00 \| 22.8 \|
		\| sharp \| buffer \| file \| 26.33 \| 23.0 \|
		\| sharp \| buffer \| buffer \| 26.43 \| 23.1 \|
		\| jimp \| buffer \| buffer \| 0.71 \| 1.0 \|
		\| mapnik \| buffer \| buffer \| 3.32 \| 4.7 \|
		\| gm \| buffer \| buffer \| 3.97 \| 5.6 \|
		\| imagemagick-native \| buffer \| buffer \| 4.06 \| 5.7 \|
		\| imagemagick \| file \| file \| 4.24 \| 6.0 \|
		\| sharp \| stream \| stream \| 25.30 \| 35.6 \|
		\| sharp \| file \| file \| 26.17 \| 36.9 \|
		\| sharp \| buffer \| buffer \| 26.45 \| 37.3 \|

		@@ -62,3 +55,3 @@ Greater libvips performance can be expected with caching enabled (default)
		```sh
		sudo apt-get install imagemagick libmagick++-dev graphicsmagick mapnik-dev
		sudo apt-get install imagemagick libmagick++-dev graphicsmagick libmapnik-dev
		```
		@@ -65,0 +58,0 @@

install/libvips.js

		@@ -21,2 +21,8 @@ 'use strict';

		const fail = function (err) {
		npmLog.error('sharp', err.message);
		npmLog.error('sharp', 'Please see http://sharp.pixelplumbing.com/page/install');
		process.exit(1);
		};

		const extractTarball = function (tarPath) {
		@@ -31,5 +37,3 @@ const vendorPath = path.join(__dirname, '..', 'vendor');
		})
		.catch(function (err) {
		throw err;
		});
		.catch(fail);
		};
		@@ -59,5 +63,2 @@
		}
		if (detectLibc.isNonGlibcLinux) {
		throw new Error(`Use with ${detectLibc.family} libc requires manual installation of libvips >= ${minimumLibvipsVersion}`);
		}
		if (detectLibc.family === detectLibc.GLIBC && detectLibc.version && semver.lt(`${detectLibc.version}.0`, '2.13.0')) {
		@@ -86,19 +87,19 @@ throw new Error(`Use with glibc version ${detectLibc.version} requires manual installation of libvips >= ${minimumLibvipsVersion}`);
		});
		tmpFile.on('close', function () {
		try {
		// Attempt to rename
		fs.renameSync(tarPathTemp, tarPathCache);
		} catch (err) {
		// Fall back to copy and unlink
		copyFileSync(tarPathTemp, tarPathCache);
		fs.unlinkSync(tarPathTemp);
		}
		extractTarball(tarPathCache);
		});
		tmpFile
		.on('error', fail)
		.on('close', function () {
		try {
		// Attempt to rename
		fs.renameSync(tarPathTemp, tarPathCache);
		} catch (err) {
		// Fall back to copy and unlink
		copyFileSync(tarPathTemp, tarPathCache);
		fs.unlinkSync(tarPathTemp);
		}
		extractTarball(tarPathCache);
		});
		}
		}
		} catch (err) {
		npmLog.error('sharp', err.message);
		npmLog.error('sharp', 'Please see http://sharp.pixelplumbing.com/page/install');
		process.exit(1);
		fail(err);
		}

lib/colour.js

		'use strict';

		const deprecate = require('util').deprecate;

		const color = require('color');
		@@ -19,16 +21,8 @@ const is = require('./is');
		/**
		* Set the background for the `embed`, `flatten` and `extend` operations.
		* The default background is `{r: 0, g: 0, b: 0, alpha: 1}`, black without transparency.
		*
		* Delegates to the _color_ module, which can throw an Error
		* but is liberal in what it accepts, clipping values to sensible min/max.
		* The alpha value is a float between `0` (transparent) and `1` (opaque).
		*
		* @param {String\|Object} rgba - parsed by the [color](https://www.npmjs.org/package/color) module to extract values for red, green, blue and alpha.
		* @returns {Sharp}
		* @throws {Error} Invalid parameter
		* @deprecated
		* @private
		*/
		function background (rgba) {
		const colour = color(rgba);
		this.options.background = [
		const background = [
		colour.red(),
		@@ -39,2 +33,5 @@ colour.green(),
		];
		this.options.resizeBackground = background;
		this.options.extendBackground = background;
		this.options.flattenBackground = background.slice(0, 3);
		return this;
		@@ -85,3 +82,3 @@ }
		* By default output image will be web-friendly sRGB, with additional channels interpreted as alpha channels.
		* @param {String} [colourspace] - output colourspace e.g. `srgb`, `rgb`, `cmyk`, `lab`, `b-w` [...](https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/enumtypes.c#L568)
		* @param {String} [colourspace] - output colourspace e.g. `srgb`, `rgb`, `cmyk`, `lab`, `b-w` [...](https://github.com/libvips/libvips/blob/master/libvips/iofuncs/enumtypes.c#L568)
		* @returns {Sharp}
		@@ -109,2 +106,21 @@ * @throws {Error} Invalid parameters
		/**
		* Update a colour attribute of the this.options Object.
		* @private
		* @param {String} key
		* @param {String\|Object} val
		* @throws {Error} Invalid key
		*/
		function _setColourOption (key, val) {
		if (is.object(val) \|\| is.string(val)) {
		const colour = color(val);
		this.options[key] = [
		colour.red(),
		colour.green(),
		colour.blue(),
		Math.round(colour.alpha() * 255)
		];
		}
		}

		/**
		* Decorate the Sharp prototype with colour-related functions.
		@@ -114,5 +130,4 @@ * @private
		module.exports = function (Sharp) {
		// Public instance functions
		[
		background,
		// Public
		tint,
		@@ -122,3 +137,5 @@ greyscale,
		toColourspace,
		toColorspace
		toColorspace,
		// Private
		_setColourOption
		].forEach(function (f) {
		@@ -130,2 +147,4 @@ Sharp.prototype[f.name] = f;
		Sharp.colorspace = colourspace;
		// Deprecated
		Sharp.prototype.background = deprecate(background, 'background(background) is deprecated, use resize({ background }), extend({ background }) or flatten({ background }) instead');
		};

lib/constructor.js

		@@ -7,39 +7,7 @@ 'use strict';
		const events = require('events');
		const semver = require('semver');
		const is = require('./is');
		const platform = require('./platform');

		require('./libvips').hasVendoredLibvips();
		const sharp = require('../build/Release/sharp.node');

		// Vendor platform
		(function () {
		let vendorPlatformId;
		try {
		vendorPlatformId = require('../vendor/platform.json');
		} catch (err) {
		return;
		}
		const currentPlatformId = platform();
		/* istanbul ignore if */
		if (currentPlatformId !== vendorPlatformId) {
		throw new Error(`'${vendorPlatformId}' binaries cannot be used on the '${currentPlatformId}' platform. Please remove the 'node_modules/sharp/vendor' directory and run 'npm rebuild'.`);
		}
		})();

		// Versioning
		let versions = {
		vips: sharp.libvipsVersion()
		};
		(function () {
		// Does libvips meet minimum requirement?
		const libvipsVersionMin = require('../package.json').config.libvips;
		/* istanbul ignore if */
		if (semver.lt(versions.vips, libvipsVersionMin)) {
		throw new Error('Found libvips ' + versions.vips + ' but require at least ' + libvipsVersionMin);
		}
		// Include versions of dependencies, if present
		try {
		versions = require('../vendor/versions.json');
		} catch (err) {}
		})();

		// Use NODE_DEBUG=sharp to enable libvips warnings
		@@ -140,6 +108,8 @@ const debuglog = util.debuglog('sharp');
		canvas: 'crop',
		crop: 0,
		embed: 0,
		position: 0,
		resizeBackground: [0, 0, 0, 255],
		useExifOrientation: false,
		angle: 0,
		rotationAngle: 0,
		rotationBackground: [0, 0, 0, 255],
		rotateBeforePreExtract: false,
		@@ -152,2 +122,3 @@ flip: false,
		extendRight: 0,
		extendBackground: [0, 0, 0, 255],
		withoutEnlargement: false,
		@@ -157,6 +128,6 @@ kernel: 'lanczos3',
		// operations
		background: [0, 0, 0, 255],
		tintA: 128,
		tintB: 128,
		flatten: false,
		flattenBackground: [0, 0, 0],
		negate: false,
		@@ -170,3 +141,3 @@ medianSize: 0,
		thresholdGrayscale: true,
		trimTolerance: 0,
		trimThreshold: 0,
		gamma: 0,
		@@ -259,3 +230,8 @@ greyscale: false,
		*/
		Sharp.versions = versions;
		Sharp.versions = {
		vips: sharp.libvipsVersion()
		};
		try {
		Sharp.versions = require('../vendor/versions.json');
		} catch (err) {}

		@@ -262,0 +238,0 @@ /**

lib/input.js

		@@ -180,8 +180,11 @@ 'use strict';
		* - `format`: Name of decoder used to decompress image data e.g. `jpeg`, `png`, `webp`, `gif`, `svg`
		* - `size`: Total size of image in bytes, for Stream and Buffer input only
		* - `width`: Number of pixels wide (EXIF orientation is not taken into consideration)
		* - `height`: Number of pixels high (EXIF orientation is not taken into consideration)
		* - `space`: Name of colour space interpretation e.g. `srgb`, `rgb`, `cmyk`, `lab`, `b-w` [...](https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/enumtypes.c#L636)
		* - `space`: Name of colour space interpretation e.g. `srgb`, `rgb`, `cmyk`, `lab`, `b-w` [...](https://github.com/libvips/libvips/blob/master/libvips/iofuncs/enumtypes.c#L636)
		* - `channels`: Number of bands e.g. `3` for sRGB, `4` for CMYK
		* - `depth`: Name of pixel depth format e.g. `uchar`, `char`, `ushort`, `float` [...](https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/enumtypes.c#L672)
		* - `depth`: Name of pixel depth format e.g. `uchar`, `char`, `ushort`, `float` [...](https://github.com/libvips/libvips/blob/master/libvips/iofuncs/enumtypes.c#L672)
		* - `density`: Number of pixels per inch (DPI), if present
		* - `chromaSubsampling`: String containing JPEG chroma subsampling, `4:2:0` or `4:4:4` for RGB, `4:2:0:4` or `4:4:4:4` for CMYK
		* - `isProgressive`: Boolean indicating whether the image is interlaced using a progressive scan
		* - `hasProfile`: Boolean indicating the presence of an embedded ICC profile
		@@ -188,0 +191,0 @@ * - `hasAlpha`: Boolean indicating the presence of an alpha transparency channel

lib/libvips.js

		@@ -47,6 +47,12 @@ 'use strict';
		const currentPlatformId = platform();
		const vendorPath = path.join(__dirname, '..', 'vendor');
		let vendorVersionId;
		let vendorPlatformId;
		try {
		vendorPlatformId = require(path.join(__dirname, '..', 'vendor', 'platform.json'));
		vendorVersionId = require(path.join(vendorPath, 'versions.json')).vips;
		vendorPlatformId = require(path.join(vendorPath, 'platform.json'));
		} catch (err) {}
		if (vendorVersionId && vendorVersionId !== minimumLibvipsVersion) {
		throw new Error(`Found vendored libvips v${vendorVersionId} but require v${minimumLibvipsVersion}. Please remove the 'node_modules/sharp/vendor' directory and run 'npm install'.`);
		}
		if (vendorPlatformId) {
		@@ -53,0 +59,0 @@ if (currentPlatformId === vendorPlatformId) {

145

lib/operation.js

		'use strict';

		const color = require('color');
		const is = require('./is');
		@@ -9,5 +10,8 @@
		*
		* If an angle is provided, it is converted to a valid 90/180/270deg rotation.
		* If an angle is provided, it is converted to a valid positive degree rotation.
		* For example, `-450` will produce a 270deg rotation.
		*
		* When rotating by an angle other than a multiple of 90,
		* the background colour can be provided with the `background` option.
		*
		* If no angle is provided, it is determined from the EXIF data.
		@@ -32,7 +36,9 @@ * Mirroring is supported and may infer the use of a flip operation.
		*
		* @param {Number} [angle=auto] angle of rotation, must be a multiple of 90.
		* @param {Number} [angle=auto] angle of rotation.
		* @param {Object} [options] - if present, is an Object with optional attributes.
		* @param {String\|Object} [options.background="#000000"] parsed by the [color](https://www.npmjs.org/package/color) module to extract values for red, green, blue and alpha.
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function rotate (angle) {
		function rotate (angle, options) {
		if (!is.defined(angle)) {
		@@ -42,4 +48,15 @@ this.options.useExifOrientation = true;
		this.options.angle = angle;
		} else if (is.number(angle)) {
		this.options.rotationAngle = angle;
		if (is.object(options) && options.background) {
		const backgroundColour = color(options.background);
		this.options.rotationBackground = [
		backgroundColour.red(),
		backgroundColour.green(),
		backgroundColour.blue(),
		Math.round(backgroundColour.alpha() * 255)
		];
		}
		} else {
		throw new Error('Unsupported angle: angle must be a positive/negative multiple of 90 ' + angle);
		throw new Error('Unsupported angle: must be a number.');
		}
		@@ -50,49 +67,2 @@ return this;
		/**
		* Extract a region of the image.
		*
		* - Use `extract` before `resize` for pre-resize extraction.
		* - Use `extract` after `resize` for post-resize extraction.
		* - Use `extract` before and after for both.
		*
		* @example
		* sharp(input)
		* .extract({ left: left, top: top, width: width, height: height })
		* .toFile(output, function(err) {
		* // Extract a region of the input image, saving in the same format.
		* });
		* @example
		* sharp(input)
		* .extract({ left: leftOffsetPre, top: topOffsetPre, width: widthPre, height: heightPre })
		* .resize(width, height)
		* .extract({ left: leftOffsetPost, top: topOffsetPost, width: widthPost, height: heightPost })
		* .toFile(output, function(err) {
		* // Extract a region, resize, then extract from the resized image
		* });
		*
		* @param {Object} options
		* @param {Number} options.left - zero-indexed offset from left edge
		* @param {Number} options.top - zero-indexed offset from top edge
		* @param {Number} options.width - dimension of extracted image
		* @param {Number} options.height - dimension of extracted image
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function extract (options) {
		const suffix = this.options.width === -1 && this.options.height === -1 ? 'Pre' : 'Post';
		['left', 'top', 'width', 'height'].forEach(function (name) {
		const value = options[name];
		if (is.integer(value) && value >= 0) {
		this.options[name + (name === 'left' \|\| name === 'top' ? 'Offset' : '') + suffix] = value;
		} else {
		throw new Error('Non-integer value for ' + name + ' of ' + value);
		}
		}, this);
		// Ensure existing rotation occurs before pre-resize extraction
		if (suffix === 'Pre' && ((this.options.angle % 360) !== 0 \|\| this.options.useExifOrientation === true)) {
		this.options.rotateBeforePreExtract = true;
		}
		return this;
		}

		/**
		* Flip the image about the vertical Y axis. This always occurs after rotation, if any.
		@@ -208,68 +178,10 @@ * The use of `flip` implies the removal of the EXIF `Orientation` tag, if any.
		/**
		* Extends/pads the edges of the image with the colour provided to the `background` method.
		* This operation will always occur after resizing and extraction, if any.
		*
		* @example
		* // Resize to 140 pixels wide, then add 10 transparent pixels
		* // to the top, left and right edges and 20 to the bottom edge
		* sharp(input)
		* .resize(140)
		* .background({r: 0, g: 0, b: 0, alpha: 0})
		* .extend({top: 10, bottom: 20, left: 10, right: 10})
		* ...
		*
		* @param {(Number\|Object)} extend - single pixel count to add to all edges or an Object with per-edge counts
		* @param {Number} [extend.top]
		* @param {Number} [extend.left]
		* @param {Number} [extend.bottom]
		* @param {Number} [extend.right]
		* Merge alpha transparency channel, if any, with a background.
		* @param {String\|Object} [options.background={r: 0, g: 0, b: 0}] - background colour, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to black.
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function extend (extend) {
		if (is.integer(extend) && extend > 0) {
		this.options.extendTop = extend;
		this.options.extendBottom = extend;
		this.options.extendLeft = extend;
		this.options.extendRight = extend;
		} else if (
		is.object(extend) &&
		is.integer(extend.top) && extend.top >= 0 &&
		is.integer(extend.bottom) && extend.bottom >= 0 &&
		is.integer(extend.left) && extend.left >= 0 &&
		is.integer(extend.right) && extend.right >= 0
		) {
		this.options.extendTop = extend.top;
		this.options.extendBottom = extend.bottom;
		this.options.extendLeft = extend.left;
		this.options.extendRight = extend.right;
		} else {
		throw new Error('Invalid edge extension ' + extend);
		}
		return this;
		}

		/**
		* Merge alpha transparency channel, if any, with `background`.
		* @param {Boolean} [flatten=true]
		* @returns {Sharp}
		*/
		function flatten (flatten) {
		this.options.flatten = is.bool(flatten) ? flatten : true;
		return this;
		}

		/**
		* Trim "boring" pixels from all edges that contain values within a percentage similarity of the top-left pixel.
		* @param {Number} [tolerance=10] value between 1 and 99 representing the percentage similarity.
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function trim (tolerance) {
		if (!is.defined(tolerance)) {
		this.options.trimTolerance = 10;
		} else if (is.integer(tolerance) && is.inRange(tolerance, 1, 99)) {
		this.options.trimTolerance = tolerance;
		} else {
		throw new Error('Invalid trim tolerance (1 to 99) ' + tolerance);
		function flatten (options) {
		this.options.flatten = is.bool(options) ? options : true;
		if (is.object(options)) {
		this._setColourOption('flattenBackground', options.background);
		}
		@@ -468,3 +380,2 @@ return this;
		rotate,
		extract,
		flip,
		@@ -475,5 +386,3 @@ flop,
		blur,
		extend,
		flatten,
		trim,
		gamma,
		@@ -480,0 +389,0 @@ negate,

lib/platform.js

		'use strict';

		const detectLibc = require('detect-libc');

		module.exports = function () {
		const arch = process.env.npm_config_arch \|\| process.arch;
		const platform = process.env.npm_config_platform \|\| process.platform;
		const libc = (platform === 'linux' && detectLibc.isNonGlibcLinux) ? detectLibc.family : '';

		const platformId = [platform];
		const platformId = [`${platform}${libc}`];
		if (arch === 'arm' \|\| arch === 'armhf' \|\| arch === 'arm64') {
		@@ -9,0 +12,0 @@ const armVersion = (arch === 'arm64') ? '8' : process.env.npm_config_armv \|\| process.config.variables.arm_version \|\| '6';

412

lib/resize.js

		'use strict';

		const deprecate = require('util').deprecate;
		const is = require('./is');

		/**
		* Weighting to apply to image crop.
		* Weighting to apply when using contain/cover fit.
		* @member
		@@ -24,6 +25,22 @@ * @private
		/**
		* Strategies for automagic crop behaviour.
		* Position to apply when using contain/cover fit.
		* @member
		* @private
		*/
		const position = {
		top: 1,
		right: 2,
		bottom: 3,
		left: 4,
		'right top': 5,
		'right bottom': 6,
		'left bottom': 7,
		'left top': 8
		};

		/**
		* Strategies for automagic cover behaviour.
		* @member
		* @private
		*/
		const strategy = {
		@@ -47,6 +64,50 @@ entropy: 16,
		/**
		* Resize image to `width` x `height`.
		* By default, the resized image is centre cropped to the exact size specified.
		* Methods by which an image can be resized to fit the provided dimensions.
		* @member
		* @private
		*/
		const fit = {
		contain: 'contain',
		cover: 'cover',
		fill: 'fill',
		inside: 'inside',
		outside: 'outside'
		};

		/**
		* Map external fit property to internal canvas property.
		* @member
		* @private
		*/
		const mapFitToCanvas = {
		contain: 'embed',
		cover: 'crop',
		fill: 'ignore_aspect',
		inside: 'max',
		outside: 'min'
		};

		/**
		* Resize image to `width`, `height` or `width x height`.
		*
		* Possible kernels are:
		* When both a `width` and `height` are provided, the possible methods by which the image should fit these are:
		* - `cover`: Crop to cover both provided dimensions (the default).
		* - `contain`: Embed within both provided dimensions.
		* - `fill`: Ignore the aspect ratio of the input and stretch to both provided dimensions.
		* - `inside`: Preserving aspect ratio, resize the image to be as large as possible while ensuring its dimensions are less than or equal to both those specified.
		* - `outside`: Preserving aspect ratio, resize the image to be as small as possible while ensuring its dimensions are greater than or equal to both those specified.
		* Some of these values are based on the [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) CSS property.
		*
		* When using a `fit` of `cover` or `contain`, the default position is `centre`. Other options are:
		* - `sharp.position`: `top`, `right top`, `right`, `right bottom`, `bottom`, `left bottom`, `left`, `left top`.
		* - `sharp.gravity`: `north`, `northeast`, `east`, `southeast`, `south`, `southwest`, `west`, `northwest`, `center` or `centre`.
		* - `sharp.strategy`: `cover` only, dynamically crop using either the `entropy` or `attention` strategy.
		* Some of these values are based on the [object-position](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position) CSS property.
		*
		* The experimental strategy-based approach resizes so one dimension is at its target length
		* then repeatedly ranks edge regions, discarding the edge with the lowest score based on the selected strategy.
		* - `entropy`: focus on the region with the highest [Shannon entropy](https://en.wikipedia.org/wiki/Entropy_%28information_theory%29).
		* - `attention`: focus on the region with the highest luminance frequency, colour saturation and presence of skin tones.
		*
		* Possible interpolation kernels are:
		* - `nearest`: Use [nearest neighbour interpolation](http://en.wikipedia.org/wiki/Nearest-neighbor_interpolation).
		@@ -58,19 +119,70 @@ * - `cubic`: Use a [Catmull-Rom spline](https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline).
		* @example
		* sharp(inputBuffer)
		* sharp(input)
		* .resize({ width: 100 })
		* .toBuffer()
		* .then(data => {
		* // 100 pixels wide, auto-scaled height
		* });
		*
		* @example
		* sharp(input)
		* .resize({ height: 100 })
		* .toBuffer()
		* .then(data => {
		* // 100 pixels high, auto-scaled width
		* });
		*
		* @example
		* sharp(input)
		* .resize(200, 300, {
		* kernel: sharp.kernel.nearest
		* kernel: sharp.kernel.nearest,
		* fit: 'contain',
		* position: 'right top',
		* background: { r: 255, g: 255, b: 255, alpha: 0.5 }
		* })
		* .background('white')
		* .embed()
		* .toFile('output.tiff')
		* .then(function() {
		* // output.tiff is a 200 pixels wide and 300 pixels high image
		* // containing a nearest-neighbour scaled version, embedded on a white canvas,
		* // of the image data in inputBuffer
		* .toFile('output.png')
		* .then(() => {
		* // output.png is a 200 pixels wide and 300 pixels high image
		* // containing a nearest-neighbour scaled version
		* // contained within the north-east corner of a semi-transparent white canvas
		* });
		*
		* @example
		* const transformer = sharp()
		* .resize({
		* width: 200,
		* height: 200,
		* fit: sharp.fit.cover,
		* position: sharp.strategy.entropy
		* });
		* // Read image data from readableStream
		* // Write 200px square auto-cropped image data to writableStream
		* readableStream
		* .pipe(transformer)
		* .pipe(writableStream);
		*
		* @example
		* sharp(input)
		* .resize(200, 200, {
		* fit: sharp.fit.inside,
		* withoutEnlargement: true
		* })
		* .toFormat('jpeg')
		* .toBuffer()
		* .then(function(outputBuffer) {
		* // outputBuffer contains JPEG image data
		* // no wider and no higher than 200 pixels
		* // and no larger than the input image
		* });
		*
		* @param {Number} [width] - pixels wide the resultant image should be. Use `null` or `undefined` to auto-scale the width to match the height.
		* @param {Number} [height] - pixels high the resultant image should be. Use `null` or `undefined` to auto-scale the height to match the width.
		* @param {Object} [options]
		* @param {String} [options.width] - alternative means of specifying `width`. If both are present this take priority.
		* @param {String} [options.height] - alternative means of specifying `height`. If both are present this take priority.
		* @param {String} [options.fit='cover'] - how the image should be resized to fit both provided dimensions, one of `cover`, `contain`, `fill`, `inside` or `outside`.
		* @param {String} [options.position='centre'] - position, gravity or strategy to use when `fit` is `cover` or `contain`.
		* @param {String\|Object} [options.background={r: 0, g: 0, b: 0, alpha: 1}] - background colour when using a `fit` of `contain`, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to black without transparency.
		* @param {String} [options.kernel='lanczos3'] - the kernel to use for image reduction.
		* @param {Boolean} [options.withoutEnlargement=false] - do not enlarge if the width or height are already less than the specified dimensions, equivalent to GraphicsMagick's `>` geometry option.
		* @param {Boolean} [options.fastShrinkOnLoad=true] - take greater advantage of the JPEG and WebP shrink-on-load feature, which can lead to a slight moiré pattern on some images.
		@@ -82,3 +194,5 @@ * @returns {Sharp}
		if (is.defined(width)) {
		if (is.integer(width) && width > 0) {
		if (is.object(width) && !is.defined(options)) {
		options = width;
		} else if (is.integer(width) && width > 0) {
		this.options.width = width;
		@@ -101,2 +215,34 @@ } else {
		if (is.object(options)) {
		// Width
		if (is.integer(options.width) && options.width > 0) {
		this.options.width = options.width;
		}
		// Height
		if (is.integer(options.height) && options.height > 0) {
		this.options.height = options.height;
		}
		// Fit
		if (is.defined(options.fit)) {
		const canvas = mapFitToCanvas[options.fit];
		if (is.string(canvas)) {
		this.options.canvas = canvas;
		} else {
		throw is.invalidParameterError('fit', 'valid fit', options.fit);
		}
		}
		// Position
		if (is.defined(options.position)) {
		const pos = is.integer(options.position)
		? options.position
		: strategy[options.position] \|\| position[options.position] \|\| gravity[options.position];
		if (is.integer(pos) && (is.inRange(pos, 0, 8) \|\| is.inRange(pos, 16, 17))) {
		this.options.position = pos;
		} else {
		throw is.invalidParameterError('position', 'valid position/gravity/strategy', options.position);
		}
		}
		// Background
		if (is.defined(options.background)) {
		this._setColourOption('resizeBackground', options.background);
		}
		// Kernel
		@@ -110,2 +256,6 @@ if (is.defined(options.kernel)) {
		}
		// Without enlargement
		if (is.defined(options.withoutEnlargement)) {
		this._setBooleanOption('withoutEnlargement', options.withoutEnlargement);
		}
		// Shrink on load
		@@ -120,27 +270,124 @@ if (is.defined(options.fastShrinkOnLoad)) {
		/**
		* Crop the resized image to the exact size specified, the default behaviour.
		* Extends/pads the edges of the image with the provided background colour.
		* This operation will always occur after resizing and extraction, if any.
		*
		* Possible attributes of the optional `sharp.gravity` are `north`, `northeast`, `east`, `southeast`, `south`,
		* `southwest`, `west`, `northwest`, `center` and `centre`.
		* @example
		* // Resize to 140 pixels wide, then add 10 transparent pixels
		* // to the top, left and right edges and 20 to the bottom edge
		* sharp(input)
		* .resize(140)
		* .)
		* .extend({
		* top: 10,
		* bottom: 20,
		* left: 10,
		* right: 10
		* background: { r: 0, g: 0, b: 0, alpha: 0 }
		* })
		* ...
		*
		* The experimental strategy-based approach resizes so one dimension is at its target length
		* then repeatedly ranks edge regions, discarding the edge with the lowest score based on the selected strategy.
		* - `entropy`: focus on the region with the highest [Shannon entropy](https://en.wikipedia.org/wiki/Entropy_%28information_theory%29).
		* - `attention`: focus on the region with the highest luminance frequency, colour saturation and presence of skin tones.
		* @param {(Number\|Object)} extend - single pixel count to add to all edges or an Object with per-edge counts
		* @param {Number} [extend.top]
		* @param {Number} [extend.left]
		* @param {Number} [extend.bottom]
		* @param {Number} [extend.right]
		* @param {String\|Object} [extend.background={r: 0, g: 0, b: 0, alpha: 1}] - background colour, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to black without transparency.
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function extend (extend) {
		if (is.integer(extend) && extend > 0) {
		this.options.extendTop = extend;
		this.options.extendBottom = extend;
		this.options.extendLeft = extend;
		this.options.extendRight = extend;
		} else if (
		is.object(extend) &&
		is.integer(extend.top) && extend.top >= 0 &&
		is.integer(extend.bottom) && extend.bottom >= 0 &&
		is.integer(extend.left) && extend.left >= 0 &&
		is.integer(extend.right) && extend.right >= 0
		) {
		this.options.extendTop = extend.top;
		this.options.extendBottom = extend.bottom;
		this.options.extendLeft = extend.left;
		this.options.extendRight = extend.right;
		this._setColourOption('extendBackground', extend.background);
		} else {
		throw new Error('Invalid edge extension ' + extend);
		}
		return this;
		}

		/**
		* Extract a region of the image.
		*
		* - Use `extract` before `resize` for pre-resize extraction.
		* - Use `extract` after `resize` for post-resize extraction.
		* - Use `extract` before and after for both.
		*
		* @example
		* const transformer = sharp()
		* .resize(200, 200)
		* .crop(sharp.strategy.entropy)
		* .on('error', function(err) {
		* console.log(err);
		* sharp(input)
		* .extract({ left: left, top: top, width: width, height: height })
		* .toFile(output, function(err) {
		* // Extract a region of the input image, saving in the same format.
		* });
		* // Read image data from readableStream
		* // Write 200px square auto-cropped image data to writableStream
		* readableStream.pipe(transformer).pipe(writableStream);
		* @example
		* sharp(input)
		* .extract({ left: leftOffsetPre, top: topOffsetPre, width: widthPre, height: heightPre })
		* .resize(width, height)
		* .extract({ left: leftOffsetPost, top: topOffsetPost, width: widthPost, height: heightPost })
		* .toFile(output, function(err) {
		* // Extract a region, resize, then extract from the resized image
		* });
		*
		* @param {String} [crop='centre'] - A member of `sharp.gravity` to crop to an edge/corner or `sharp.strategy` to crop dynamically.
		* @param {Object} options
		* @param {Number} options.left - zero-indexed offset from left edge
		* @param {Number} options.top - zero-indexed offset from top edge
		* @param {Number} options.width - dimension of extracted image
		* @param {Number} options.height - dimension of extracted image
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function extract (options) {
		const suffix = this.options.width === -1 && this.options.height === -1 ? 'Pre' : 'Post';
		['left', 'top', 'width', 'height'].forEach(function (name) {
		const value = options[name];
		if (is.integer(value) && value >= 0) {
		this.options[name + (name === 'left' \|\| name === 'top' ? 'Offset' : '') + suffix] = value;
		} else {
		throw new Error('Non-integer value for ' + name + ' of ' + value);
		}
		}, this);
		// Ensure existing rotation occurs before pre-resize extraction
		if (suffix === 'Pre' && ((this.options.angle % 360) !== 0 \|\| this.options.useExifOrientation === true)) {
		this.options.rotateBeforePreExtract = true;
		}
		return this;
		}

		/**
		* Trim "boring" pixels from all edges that contain values similar to the top-left pixel.
		* The `info` response Object will contain `trimOffsetLeft` and `trimOffsetTop` properties.
		* @param {Number} [threshold=10] the allowed difference from the top-left pixel, a number greater than zero.
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		*/
		function trim (threshold) {
		if (!is.defined(threshold)) {
		this.options.trimThreshold = 10;
		} else if (is.number(threshold) && threshold > 0) {
		this.options.trimThreshold = threshold;
		} else {
		throw is.invalidParameterError('threshold', 'number greater than zero', threshold);
		}
		return this;
		}

		// Deprecated functions

		/**
		* @deprecated
		* @private
		*/
		function crop (crop) {
		@@ -150,15 +397,15 @@ this.options.canvas = 'crop';
		// Default
		this.options.crop = gravity.center;
		this.options.position = gravity.center;
		} else if (is.integer(crop) && is.inRange(crop, 0, 8)) {
		// Gravity (numeric)
		this.options.crop = crop;
		this.options.position = crop;
		} else if (is.string(crop) && is.integer(gravity[crop])) {
		// Gravity (string)
		this.options.crop = gravity[crop];
		this.options.position = gravity[crop];
		} else if (is.integer(crop) && crop >= strategy.entropy) {
		// Strategy
		this.options.crop = crop;
		this.options.position = crop;
		} else if (is.string(crop) && is.integer(strategy[crop])) {
		// Strategy (string)
		this.options.crop = strategy[crop];
		this.options.position = strategy[crop];
		} else {
		@@ -171,41 +418,19 @@ throw is.invalidParameterError('crop', 'valid crop id/name/strategy', crop);
		/**
		* Preserving aspect ratio, resize the image to the maximum `width` or `height` specified
		* then embed on a background of the exact `width` and `height` specified.
		*
		* If the background contains an alpha value then WebP and PNG format output images will
		* contain an alpha channel, even when the input image does not.
		*
		* @example
		* sharp('input.gif')
		* .resize(200, 300)
		* .background({r: 0, g: 0, b: 0, alpha: 0})
		* .embed()
		* .toFormat(sharp.format.webp)
		* .toBuffer(function(err, outputBuffer) {
		* if (err) {
		* throw err;
		* }
		* // outputBuffer contains WebP image data of a 200 pixels wide and 300 pixels high
		* // containing a scaled version, embedded on a transparent canvas, of input.gif
		* });
		* @param {String} [embed='centre'] - A member of `sharp.gravity` to embed to an edge/corner.
		* @returns {Sharp}
		* @throws {Error} Invalid parameters
		* @deprecated
		* @private
		*/
		function embed (embed) {
		this.options.canvas = 'embed';

		if (!is.defined(embed)) {
		// Default
		this.options.embed = gravity.center;
		this.options.position = gravity.center;
		} else if (is.integer(embed) && is.inRange(embed, 0, 8)) {
		// Gravity (numeric)
		this.options.embed = embed;
		this.options.position = embed;
		} else if (is.string(embed) && is.integer(gravity[embed])) {
		// Gravity (string)
		this.options.embed = gravity[embed];
		this.options.position = gravity[embed];
		} else {
		throw is.invalidParameterError('embed', 'valid embed id/name', embed);
		}

		return this;
		@@ -215,19 +440,4 @@ }
		/**
		* Preserving aspect ratio, resize the image to be as large as possible
		* while ensuring its dimensions are less than or equal to the `width` and `height` specified.
		*
		* Both `width` and `height` must be provided via `resize` otherwise the behaviour will default to `crop`.
		*
		* @example
		* sharp(inputBuffer)
		* .resize(200, 200)
		* .max()
		* .toFormat('jpeg')
		* .toBuffer()
		* .then(function(outputBuffer) {
		* // outputBuffer contains JPEG image data no wider than 200 pixels and no higher
		* // than 200 pixels regardless of the inputBuffer image dimensions
		* });
		*
		* @returns {Sharp}
		* @deprecated
		* @private
		*/
		@@ -240,8 +450,4 @@ function max () {
		/**
		* Preserving aspect ratio, resize the image to be as small as possible
		* while ensuring its dimensions are greater than or equal to the `width` and `height` specified.
		*
		* Both `width` and `height` must be provided via `resize` otherwise the behaviour will default to `crop`.
		*
		* @returns {Sharp}
		* @deprecated
		* @private
		*/
		@@ -254,5 +460,4 @@ function min () {
		/**
		* Ignoring the aspect ratio of the input, stretch the image to
		* the exact `width` and/or `height` provided via `resize`.
		* @returns {Sharp}
		* @deprecated
		* @private
		*/
		@@ -265,11 +470,4 @@ function ignoreAspectRatio () {
		/**
		* Do not enlarge the output image if the input image width or height are already less than the required dimensions.
		* This is equivalent to GraphicsMagick's `>` geometry option:
		* "change the dimensions of the image only if its width or height exceeds the geometry specification".
		* Use with `max()` to preserve the image's aspect ratio.
		*
		* The default behaviour before function call is `false`, meaning the image will be enlarged.
		*
		* @param {Boolean} [withoutEnlargement=true]
		* @returns {Sharp}
		* @deprecated
		* @private
		*/
		@@ -288,8 +486,5 @@ function withoutEnlargement (withoutEnlargement) {
		resize,
		crop,
		embed,
		max,
		min,
		ignoreAspectRatio,
		withoutEnlargement
		extend,
		extract,
		trim
		].forEach(function (f) {
		@@ -302,2 +497,11 @@ Sharp.prototype[f.name] = f;
		Sharp.kernel = kernel;
		Sharp.fit = fit;
		Sharp.position = position;
		// Deprecated functions, to be removed in v0.22.0
		Sharp.prototype.crop = deprecate(crop, 'crop(position) is deprecated, use resize({ fit: "cover", position }) instead');
		Sharp.prototype.embed = deprecate(embed, 'embed(position) is deprecated, use resize({ fit: "contain", position }) instead');
		Sharp.prototype.max = deprecate(max, 'max() is deprecated, use resize({ fit: "inside" }) instead');
		Sharp.prototype.min = deprecate(min, 'min() is deprecated, use resize({ fit: "outside" }) instead');
		Sharp.prototype.ignoreAspectRatio = deprecate(ignoreAspectRatio, 'ignoreAspectRatio() is deprecated, use resize({ fit: "fill" }) instead');
		Sharp.prototype.withoutEnlargement = deprecate(withoutEnlargement, 'withoutEnlargement() is deprecated, use resize({ withoutEnlargement: true }) instead');
		};

lib/utility.js

		@@ -85,13 +85,10 @@ 'use strict';
		*
		* This feature is currently off by default but future versions may reverse this.
		* Versions of liborc prior to 0.4.25 are known to segfault under heavy load.
		*
		* @example
		* const simd = sharp.simd();
		* // simd is `true` if SIMD is currently enabled
		* // simd is `true` if the runtime use of liborc is currently enabled
		* @example
		* const simd = sharp.simd(true);
		* // attempts to enable the use of SIMD, returning true if available
		* const simd = sharp.simd(false);
		* // prevent libvips from using liborc at runtime
		*
		* @param {Boolean} [simd=false]
		* @param {Boolean} [simd=true]
		* @returns {Boolean}
		@@ -102,3 +99,3 @@ */
		}
		simd(false);
		simd(true);

		@@ -105,0 +102,0 @@ /**

package.json

		{
		"name": "sharp",
		"description": "High performance Node.js image processing, the fastest module to resize JPEG, PNG, WebP and TIFF images",
		"version": "0.20.8",
		"version": "0.21.0",
		"author": "Lovell Fuller <npm@lovell.info>",
		@@ -57,7 +57,8 @@ "homepage": "https://github.com/lovell/sharp",
		"Aidan Hoolachan <ajhoolachan21@gmail.com>",
		"Axel Eirola <axel.eirola@iki.fi>"
		"Axel Eirola <axel.eirola@iki.fi>",
		"Freezy <freezy@xbmc.org>"
		],
		"scripts": {
		"install": "(node install/libvips && node install/dll-copy && prebuild-install) \|\| (node-gyp rebuild && node install/dll-copy)",
		"clean": "rm -rf node_modules/ build/ vendor/ coverage/ test/fixtures/output.*",
		"clean": "rm -rf node_modules/ build/ vendor/ .nyc_output/ coverage/ test/fixtures/output.*",
		"test": "semistandard && cc && nyc --reporter=lcov --branches=99 mocha --slow=5000 --timeout=60000 ./test/unit/*.js && prebuild-ci",
		@@ -92,8 +93,8 @@ "coverage": "./test/coverage/report.sh",
		"detect-libc": "^1.0.3",
		"nan": "^2.11.0",
		"nan": "^2.11.1",
		"fs-copy-file-sync": "^1.1.1",
		"npmlog": "^4.1.2",
		"prebuild-install": "^4.0.0",
		"prebuild-install": "^5.2.0",
		"semver": "^5.5.1",
		"simple-get": "^2.8.1",
		"simple-get": "^3.0.3",
		"tar": "^4.4.6",
		@@ -110,5 +111,5 @@ "tunnel-agent": "^0.6.0"
		"mocha": "^5.2.0",
		"mock-fs": "^4.6.0",
		"nyc": "^12.0.1",
		"prebuild": "^7.6.2",
		"mock-fs": "^4.7.0",
		"nyc": "^13.1.0",
		"prebuild": "^8.1.0",
		"prebuild-ci": "^2.2.3",
		@@ -120,6 +121,6 @@ "rimraf": "^2.6.2",
		"config": {
		"libvips": "8.6.1"
		"libvips": "8.7.0"
		},
		"engines": {
		"node": ">=4.5.0"
		"node": ">=6"
		},
		@@ -126,0 +127,0 @@ "semistandard": {

README.md

		@@ -24,4 +24,4 @@ # sharp

		Most modern 64-bit OS X, Windows and Linux (glibc) systems running
		Node versions 4, 6, 8 and 10
		Most modern 64-bit OS X, Windows and Linux systems running
		Node versions 6, 8 and 10
		do not require any additional install or runtime dependencies.
		@@ -82,3 +82,3 @@

		### Licence
		### Licensing

		@@ -85,0 +85,0 @@ Copyright 2013, 2014, 2015, 2016, 2017, 2018 Lovell Fuller and contributors.

binding.gyp