image-magick-js

ImageMagickJS

ImageMagick wrapper for nodeJS. ImageMagick should be installed on dev and prod machine in order to work. For windows users you need to add a PATH env variable called "magick" and linking to magick.exe. Latest release can be found at imagemagick.org

Feel free to contribute. More commands will come soon. If you want one you can open an issue ticket.

Install

Install using your package manager :

npm i --save image-magick-js
or
yarn add image-magick-js

Import the package in your js / ts file :

const  magick = require("image-magick-js");
or
import magick from "image-magick-js";

Available commands

custom

Send custom command to magick.

options : string, magick command with custom options

const options = "convert -background lightblue -fill blue \
      -pointsize 72 label:christophe \
      label.gif";
magick.cmds
.custom(options)
.then((response) => console.log(response))
.catch((e) => {console.log(e);});

convert

format sourceFile : string, path to source image. targetFile: string, path to target image.

magick.cmds
.convert.format("c:\\images\\a.png", "c:\\images\\a.jpg")
.then((response) => console.log(response))
.catch((e) => {console.log(e);});

resize sourceFile : string, path to source image. targetFile: string, path to target image. resize : string, new size, can be "50%", "800x600", "4096@". force : boolean, optional, force the new size even if ratio is not preserved.

magick.cmds
.convert.resize(sourceFile, targetFile, resize, true)
.then((response) => console.log(response))
.catch((e) => {console.log(e);});

caption targetFile: string, path to target image (if the file doesn't exist it will be created). caption: string, text you want to write inside image. pointSize: number, optional, font size. size: string, optional, image ratio. gravity: string, optional, text position ("Center", "South", "North", "East", "West", "NorthWest", "NorthEast", "SouthWest", "SouthEast").

magick.cmds
.convert.caption(targetFile, "Hello world", 40, "800x600", "Center")
.then((response) => console.log(response))
.catch((e) => {console.log(e);});

identify

file: string, options: string,

  magick.cmds
.identify(file, options)
.then((response) => console.log(response))
.catch((e) => {console.log(e);});

response object is like this :
{
    filename: string;
    imageFormat: string;
    widthXheight: string;
    pageWidthXpageHeightXoffsetYoffset: string;
    colorspace: string;
    weight: string;
    userTime: string;
    elapsedTime: string;
    error: string;
}