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

Commands can be used with a classic promise or inside an async function using await.

custom

Send custom command to magick.

Parameters :
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
Parameters :
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
Parameters :
sourceFile : string, path to source image.
targetFile : string, path to target image (if the file doesn't exist it will be created).
resize : string, new size, can be "50%", "800x600" or "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
Parameters :
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

Parameters :
file : string, file to analyse

  magick.cmds
.identify(file)
.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;
}