Magician
Library for easy image manipulation. Requires ImageMagick.
Features
- Conversion from/to different formats
- Resizing
- Cropping
- Defining and executing custom processing on given image (filters, middleware)
- Defining presets
Installation
npm install magician --save
Requirements
- node v0.11.x (or newer)
- imagemagick
If you are happy user of Mac, you can install ImageMagick using HomeBrew:
brew install imagemagick
or using ImageMagick Installer by CactusLab.
Getting Started
Simplest example of using Magician:
var Image = ; var image = '/path/to/image.jpg';image width500 height300; var newImage = image// newImage is an Image instance, which points to a newly created image
Guide
Assuming the beginning of all code listings is:
var Image = ;
Conversion from/to different formats
var image = '/tmp/image.png';image; var convertedImage = image;// convertedImage is an Image instance that points to a converted image// allows further processing without the need to create a new Image
Alternative way:
var image = '/tmp/image.png'; var convertedImage = image;// convertedImage is an Image instance that points to a converted image// allows further processing without the need to create a new Image
Resizing
var image = '/tmp/image.png';imagewidth500 height300; var resizedImage = image;// resizedImage is an Image instance that points to a resized image// allows further processing without the need to create a new Image
Alternative way:
var image = '/tmp/image.png';image; var resizedImage = image;// resizedImage is an Image instance that points to a resized image// allows further processing without the need to create a new Image
Cropping
var image = '/tmp/image.png';image; // x, y, width, height var croppedImage = image;// croppedImage is an Image instance that points to a resized image// allows further processing without the need to create a new Image
Defining custom processing
var image = '/tmp/image.png';image; var trimmedImage = image// done
Ability to set a URL as a source
var image = 'http://example.com/image.png';image; var downloadedImage = image;// image downloaded, done
Defining presets
Presets stop repetition and provide a fast way to use all the needed methods and filters on different Image instances using one line:
Image width300 height240 ; var image = '/tmp/image.png';image var mobileImage = image;// done
Tests
You can run tests by executing:
npm test
License
Magician is released under the MIT License.