nodejs图片处理工具gm用法

# 安装

首先要安装 GraphicsMagick (opens new window)或者ImageMagick (opens new window)，然后安装gm:

npm install --save gm

# 基本用法

图片尺寸

gm('img.png')
.size(function (err, size) {
  if (!err)
    console.log(size.width > size.height ? 'wider' : 'taller than you');
});

1
2
3
4
5

图片伸缩 可以只依据宽、高或者同时将宽高都放缩。

gm("img.png").resize(width)//保持宽高比
gm("img.png").resize(null, height)//保持宽高比
gm("img.png").resize(width, height, '!')//参数'!'用于忽略宽高比

1
2
3

图片旋转 将图片旋转degrees，背景填充color。

gm("img.png").rotate(color, degrees)
gm("img.png").rotate('green', 45)

1
2

图片裁剪 从图片的(x, y)位置开始，裁剪出一个宽为width，高为height的图片来。

gm("img.png").crop(width, height, x, y)

图片拼接(mosaic)

gm()
 .in('-page', '+0+0')
 .in('bg.jpg')
 .in('-page', '+10+20') // location of smallIcon.jpg is x,y -> 10, 20
 .in('smallIcon.jpg')
 .mosaic()
 .write('tesOutput.jpg', function (err) {
    if (err) console.log(err);
 });

1
2
3
4
5
6
7
8
9

图片合成(compose)

gm()
.command("composite") 
.in("-gravity", "center")
.in(change_image_url)
.in(base_image_url)
.write( output_file, function (err) {
  if (!err) 
    console.log(' hooray! ');
  else
    console.log(err);
});

1
2
3
4
5
6
7
8
9
10
11

不太清楚图片拼接(mosaic)与合成(compose)有什么区别，gm提供了两条命令，对于简单的图片合成，好像都可以使用。

图片拼接(append) gm中使用append也可以实现图片的拼接，与mosaic、compose不同的是，这里的拼接应该是不能覆盖的。缺省参数ltr表示拼接方向，布尔变量，true表示从左到右，false表示从上到下，默认false。

gm("img.png").append(img [, img, ltr])
gm("img.png").append("another.jpg", "third.gif")//从上到下拼接
gm("img.png").append("another.jpg", "third.gif", true)//从左到右拼接

1
2
3

图片注释 在图片的(x, y)位置绘制文字。

gm("img.png").drawText(10, 50, "from scratch")

创建图片

gm(200, 400, "#ddff99f3")
.drawText(10, 50, "from scratch")
.write("/path/to/brandNewImg.jpg", function (err) {
  // ...
});

1
2
3
4
5

压缩图片

 gm(url1)
      .resize(1200)     //设置压缩后的w/h
      .setFormat('jpeg')
      .quality(80)       //设置压缩质量: 0-100
      .strip()
      .autoOrient()
      .write(url2, function (err) {
        if (err) { reject(err); } else { resolve() }
      });

1
2
3
4
5
6
7
8
9

# 总结

gm具有强大的图片处理功能，nodejs还是借助于gm工具来实现的图片处理，对于需要后台处理图片的情形，这个是挺有用的。

gm提供的各个函数其实可以复合使用，就是说，先读取(gm)图片后，可以先进行拼接(mosaic, compose, append)，然后裁剪(crop)，放缩(resize)到指定大小后，最后才保存(write)下来。

gm的官方文档感觉过于简陋，网上的关于nodejs gm用法的资料也不多，本文将一些基本的用法总结下来，学到到新的持续更新。

另外，欢迎大家总结nodejs gm资料！

#NodeJs #gm

上次更新: 2024/02/20, 17:31:36

← nodeJS中的http模块基本介绍 node使用ffmpeg将swf转mp4 截取mp4视频第一帧为jpg图片→