1ro 中文文档教程

Question

combine-image

将多张图片合并为一张图片

combine-image 将给定的图片按正确的顺序合并为一张图片。 当您必须将多个图像的预览生成为单个图像时，这将很有帮助。 该模块基于 [Jimp] 进行图像处理。

Install

$ npm install combine-image

Usage

import combineImage from 'combine-image';

combineImage(['image-1.png', 'image-2.jpg'])
  .then((img) => {
    // Save image as file
    img.write('out.png', () => console.log('done'));
  });

API

combineImage(images[, options])

• images Array of (String | Object | Buffer | [Jimp]) - List of images to concat. If String is passed, it will be considered to the file path. Also you can pass other [Jimp] object. An Object entry can have following options:
• src String or Buffer - A single image source to concat.
• offsetX Number (optional) - x offset to affect this image. Default is 0.
• offsetY Number (optional) - y offset to affect this image. Default is 0.
• options Object (optional)
• direction String - Direction of the merged image. If this value is col, the images will be merged vertically (col). Otherwise, If this value is row the images will be merged horizontally (row). Default is col.
• color Number (hex) - Default background color represented by RGBA hex value. Default is 0x00000000.
• offset Number - Offset in pixels between each image. Default is 0.
• margin (Number | String | Object) - Margin of the result image. If Number or String is passed, it will be considered as standard css shorthand properties (e.g. '40 40 0 10'). An Object entry can have following options:
  • top Number (optional) - Margin on top side of result image. Default is 0.
  • right Number (optional) - Margin on right side of result image. Default is 0.
  • bottom Number (optional) - Margin on bottom side of result image. Default is 0.
  • left Number (optional) - Margin on left side of result image. Default is 0.

返回包含 [Jimp] 对象的 Promise。