ibansal / magickwand

native port of imagemagick

magickwand

magickwand is the native port of imagemagick/convert, that can be used to resize and compress images. This can be used to dynamically resize images in an express/connect based server. See examples/cdn.js for a sample connect middleware.

Most other ports of imagemagick invoke the convert binary, instead of making direct API calls. While this works, API calls would be faster than invoking convert, and that is the motivation for this module.

Example

var magickwand = require('magickwand');
var fs = require('fs');

magickwand.resize('<pathtoimagefile>', { width: 300, height: 200, quality: 80 } ,function(err,data) {
  fs.writeFile('/tmp/def.jpg',data,"binary");
});

To maintain aspect ratio while resizing, set one of the width/height parameters to 0.

magickwand.resize('<pathtoimagefile>', { width: 100 },function(err,data) {
  fs.writeFile('/tmp/def.jpg',data,"binary");
});

See examples/cdn.js on how to use this module as a middleware in connect.

Requirements

magickwand uses the C library by the same name, so libmagickwand-dev should be installed. Also, pkg-config is used while building.

On Ubuntu, for example

sudo apt-get install libmagickwand-dev pkg-config

On Mac - you can use homebrew to install imagemagick.

brew install imagemagick 

On MacOS, I had trouble using the default recipie for imagemagick, as openmp would cause node process to hang. Make sure you have disabled openmp while building Imagemagick.If you use homebrew, use the --disable-openmp option while installing imagemagick.

Installation

$ npm install magickwand

Source Install / Manual Compilation

$ git clone git://github.com/qzaidi/magickwand.git
$ node-waf configure build