Mathis/sharp
1
0
Fork 0
mirror of https://github.com/lovell/sharp.git synced 2025-07-09 18:40:16 +02:00
Code Issues Packages Projects Releases Wiki Activity

Small documentation improvement plus version bump

Browse Source
This commit is contained in:
Lovell Fuller 2014-07-20 22:46:26 +01:00
parent 7df7a505ee
commit e98f2fc013
2 changed files with 30 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@ -79,15 +79,12 @@ var sharp = require('sharp');
``` ```
```javascript ```javascript
sharp('input.jpg').resize(300, 200).toFile('output.jpg', function(err, info) { sharp('input.jpg').resize(300, 200).toFile('output.jpg', function(err) {
if (err) { if (err) {
throw err; throw err;
} }
// output.jpg is a 300 pixels wide and 200 pixels high image // output.jpg is a 300 pixels wide and 200 pixels high image
// containing a scaled and cropped version of input.jpg // containing a scaled and cropped version of input.jpg
// info.width and info.height contain the final pixel dimensions of the resized image
// in this case they are the same as the input
}); });
``` ```
@ -109,23 +106,19 @@ sharp('input.png').rotate(180).resize(300).sharpen().quality(90).webp().then(fun
``` ```
```javascript ```javascript
sharp(inputBuffer).resize(200, 300).bicubicInterpolation().embedWhite().toFile('output.tiff').then(function(info) { sharp(inputBuffer).resize(200, 300).bicubicInterpolation().embedWhite().toFile('output.tiff').then(function() {
// output.tiff is a 200 pixels wide and 300 pixels high image containing a bicubic scaled // output.tiff is a 200 pixels wide and 300 pixels high image containing a bicubic scaled
// version, embedded on a white canvas, of the image data in buffer // version, embedded on a white canvas, of the image data in buffer
// info.width and info.height contain the final pixel dimensions of the resized image
}); });
``` ```
```javascript ```javascript
sharp('input.gif').resize(200, 300).embedBlack().webp(function(err, outputBuffer, info) { sharp('input.gif').resize(200, 300).embedBlack().webp(function(err, outputBuffer) {
if (err) { if (err) {
throw err; throw err;
} }
// outputBuffer contains WebP image data of a 200 pixels wide and 300 pixels high // outputBuffer contains WebP image data of a 200 pixels wide and 300 pixels high
// containing a scaled version, embedded on a black canvas, of input.gif // containing a scaled version, embedded on a black canvas, of input.gif
// info.width and info.height contain the final pixel dimensions of the resized image
}); });
``` ```
@ -133,7 +126,6 @@ sharp('input.gif').resize(200, 300).embedBlack().webp(function(err, outputBuffer
sharp(inputBuffer).resize(200, 200).max().jpeg().then(function(outputBuffer, info) { sharp(inputBuffer).resize(200, 200).max().jpeg().then(function(outputBuffer, info) {
// outputBuffer contains JPEG image data no wider than 200 pixels and no higher // outputBuffer contains JPEG image data no wider than 200 pixels and no higher
// than 200 pixels regardless of the inputBuffer image dimensions // than 200 pixels regardless of the inputBuffer image dimensions
// info.width and info.height contain the final pixel dimensions of the resized image // info.width and info.height contain the final pixel dimensions of the resized image
}); });
``` ```
@ -227,7 +219,10 @@ An advanced setting that switches the libvips access method to `VIPS_ACCESS_SEQU
`filename` is a String containing the filename to write the image data to. The format is inferred from the extension, with JPEG, PNG, WebP and TIFF supported. `filename` is a String containing the filename to write the image data to. The format is inferred from the extension, with JPEG, PNG, WebP and TIFF supported.
`callback`, if present, is called with two arguments `(err, info)` where `err` contains an error message, if any, and `info` contains the final resized image dimensions in its `width` and `height` properties. `callback`, if present, is called with two arguments `(err, info)` where:
* `err` contains an error message, if any
* `info` contains the final resized image dimensions in its `width` and `height` properties
A Promises/A+ promise is returned when `callback` is not provided. A Promises/A+ promise is returned when `callback` is not provided.
@ -235,7 +230,11 @@ A Promises/A+ promise is returned when `callback` is not provided.
Write image data to a Buffer, the format of which will match the input image. JPEG, PNG and WebP are supported. Write image data to a Buffer, the format of which will match the input image. JPEG, PNG and WebP are supported.
`callback`, if present, gets three arguments `(err, buffer, info)` where `err` is an error message, if any, `buffer` is the resultant image data, and `info` contains the final resized image dimensions in its `width` and `height` properties. `callback`, if present, gets three arguments `(err, buffer, info)` where:
* `err` is an error message, if any
* `buffer` is the resultant image data
* `info` contains the final resized image dimensions in its `width` and `height` properties
A Promises/A+ promise is returned when `callback` is not provided. A Promises/A+ promise is returned when `callback` is not provided.
@ -243,7 +242,11 @@ A Promises/A+ promise is returned when `callback` is not provided.
Write JPEG image data to a Buffer. Write JPEG image data to a Buffer.
`callback`, if present, gets three arguments `(err, buffer, info)` where `err` is an error message, if any, `buffer` is resultant JPEG image data, and `info` contains the final resized image dimensions in its `width` and `height` properties. `callback`, if present, gets three arguments `(err, buffer, info)` where:
* `err` is an error message, if any
* `buffer` is the resultant JPEG image data
* `info` contains the final resized image dimensions in its `width` and `height` properties
A Promises/A+ promise is returned when `callback` is not provided. A Promises/A+ promise is returned when `callback` is not provided.
@ -251,7 +254,11 @@ A Promises/A+ promise is returned when `callback` is not provided.
Write PNG image data to a Buffer. Write PNG image data to a Buffer.
`callback`, if present, gets three arguments `(err, buffer, info)` where `err` is an error message, if any, `buffer` is resultant PNG image data, and `info` contains the final resized image dimensions in its `width` and `height` properties. `callback`, if present, gets three arguments `(err, buffer, info)` where:
* `err` is an error message, if any
* `buffer` is the resultant PNG image data
* `info` contains the final resized image dimensions in its `width` and `height` properties
A Promises/A+ promise is returned when `callback` is not provided. A Promises/A+ promise is returned when `callback` is not provided.
@ -259,7 +266,11 @@ A Promises/A+ promise is returned when `callback` is not provided.
Write WebP image data to a Buffer. Write WebP image data to a Buffer.
`callback`, if present, gets three arguments `(err, buffer, info)` where `err` is an error message, if any, `buffer` is resultant WebP image data, and `info` contains the final resized image dimensions in its `width` and `height` properties. `callback`, if present, gets three arguments `(err, buffer, info)` where:
* `err` is an error message, if any
* `buffer` is the resultant WebP image data
* `info` contains the final resized image dimensions in its `width` and `height` properties
A Promises/A+ promise is returned when `callback` is not provided. A Promises/A+ promise is returned when `callback` is not provided.
@ -331,7 +342,7 @@ You can expect much greater performance with caching enabled (default) and using
## Licence ## Licence
Copyright 2013, 2014 Lovell Fuller and Pierre Inglebert Copyright 2013, 2014 Lovell Fuller, Pierre Inglebert, Jonathan Ong and Chanon Sajjamanochai
Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

4
package.json
View File

@ -1,6 +1,6 @@
{ {
"name": "sharp", "name": "sharp",
"version": "0.5.2", "version": "0.5.3",
"author": "Lovell Fuller <npm@lovell.info>", "author": "Lovell Fuller <npm@lovell.info>",
"contributors": [ "contributors": [
"Pierre Inglebert <pierre.inglebert@gmail.com>", "Pierre Inglebert <pierre.inglebert@gmail.com>",
@ -34,7 +34,7 @@
], ],
"dependencies": { "dependencies": {
"nan": "^1.2.0", "nan": "^1.2.0",
"bluebird": "^2.2.1" "bluebird": "^2.2.2"
}, },
"devDependencies": { "devDependencies": {
"imagemagick": "^0.1.3", "imagemagick": "^0.1.3",