您的浏览器不支持CSS3,建议使用Firfox、Chrome等浏览器,以取得最佳显示效果

sharp图片库用法总结

Web相关 68℃ 0 2周前 (11-01)

sharp用法总结

sharp是一个Node图片库,可以用来生成图片、对图片进行各种操作。

GitHub地址
https://github.com/lovell/sharp

基本用法

官方文档 http://sharp.dimens.io/en/stable/

常见用法分三步:

1、创建sharp对象,来源可以是文件、Buffer或新建图片

2、操作sharp对象,处理图片(rotate、resize、background…)、合并元素(overlayWith)等

3、保存sharp对象,可以保存为文件、Buffer等,且可以指定编码格式为jpg、png、raw等。

添加文字:text-to-svg

sharp不支持直接添加文字,添加文字可以用text-to-svg先把文字转成svg,然后让sharp合并svg。

目前还不支持文字自动换行,需要自己调用getMetrics计算文本尺寸进行分行拆分,然后分别转换。

也不支持竖向文字排版(类似CSS中的writing-mode效果)

https://github.com/shrhdk/text-to-svg

注意事项

加载SVG

加载生成的SVG时传入的应该是Buffer而不是string,传string会当成文件路径来处理,导致报错提示格式不识别。

Error: Input file is missing or of an unsupported image format

const sharp = require("sharp");
const TextToSVG = require("text-to-svg");
const textToSVG = TextToSVG.loadSync();

const svgOptions = { x: 0, y: 0, fontSize: 72, anchor: "top", attributes: { fill: "red", stroke: "black" } };

const svg = textToSVG.getSVG("hello", svgOptions);

console.log(svg);

const options = {
  create: {
    width: 600,
    height: 800,
    channels: 4,
    background: { r: 255, g: 200, b: 255, alpha: 1 }
  }
};
sharp(options)
// 注意这里不能直接传svg,要传Buffer
  .overlayWith(Buffer.from(svg), { gravity: sharp.gravity.southeast })
  .png()
  .toFile(__dirname + "/output.png");

加载raw格式数据

加载时需要传options指定宽高和通道数,否则报错提示格式不识别。

Error: Input file is missing or of an unsupported image format

const sharp = require("sharp");

const sharpOptions = {
  raw: {
    width: 600,
    height: 800,
    channels: 4
  }
};

Promise.resolve()
  .then(() => {
    return sharp({
      create: {
        width: 600,
        height: 800,
        channels: 4,
        background: { r: 255, g: 200, b: 255, alpha: 1 }
      }
    }).raw().toBuffer();
  })
  .then(data => {
    // 这里从raw格式的Buffer创建sharp,必须指定options
    return sharp(data, sharpOptions).png().toFile(__dirname + "/output.png");
  });

多个图层合并

一次链式操作不能调用多个overlayWith,后面的会覆盖掉前面的。需要合成多个元素时,应该每次创建新的sharp对象,可以用Promise写法如下;如果overlay的数量不确定,可以保存到数组中,最后用js数组的reduce实现。

https://github.com/lovell/sharp/issues/728

https://github.com/lovell/sharp/issues/405

const sharp = require("sharp");
const TextToSVG = require("text-to-svg");
const textToSVG = TextToSVG.loadSync();

const svgOptions = { x: 0, y: 0, fontSize: 72, anchor: "top", attributes: { fill: "red", stroke: "black" } };

const sharpOptions = {
  raw: {
    width: 600,
    height: 800,
    channels: 4
  }
};

Promise.resolve()
  .then(() => {
    return sharp({
      create: {
        width: 600,
        height: 800,
        channels: 4,
        background: { r: 255, g: 200, b: 255, alpha: 1 }
      }
    }).raw().toBuffer();
  })
  .then(data => {
    const svg = textToSVG.getSVG("hello1", svgOptions);
    return sharp(data, sharpOptions)
      .overlayWith(Buffer.from(svg), { gravity: sharp.gravity.southeast })
      .raw().toBuffer();
  })
  .then(data => {
    const svg = textToSVG.getSVG("hello2", svgOptions);
    return sharp(data, sharpOptions)
      .overlayWith(Buffer.from(svg), { gravity: sharp.gravity.northwest })
      .raw().toBuffer();
  })
  .then(data => {
    return sharp(data, sharpOptions).png().toFile(__dirname + "/output.png");
  });
来自为知笔记(Wiz)

最后,欢迎扫码关注微信公众号。

0

暂无评论

评论前:需填写以下信息,或 登录

用户登录

忘记密码?