a-r-d / merge-img

Merge multiple images into one single image

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

merge-img

Code Style Prev NPM Version Build Status Dependency Status

Merge multiple images into one single image in serial

merge-img simply merges passed images into one single image in serial. This may helpful for task which has to generate a preview of multiple images in single image. This moudle is based on Jimp.

figure

Install

$ npm install merge-img

Usage

import mergeImg from 'merge-img';

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

    // Get image as `Buffer`
    img.getBuffer(img.getMIME(), (buf) => console.log(buf));
  });

API

mergeImg(images[, options])

  • images Array of (String | Object | Buffer | Jimp) - List of images to concat. If String is passed, it will be considered to 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 Boolean - Direction of the merged image. If this value is true, the images will be merged vertically (column). Otherwise, the images will be merged horizontally (row). Default is false.
    • color Number (hex) - Default background color represented by RGBA hex value. Default is 0x00000000.
    • align String - Aligning of given images. If the images are not all the same size, images will be sorted to largest image. Possible values are start, center and end. Default is start.
    • 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.

Returns a Promise that contains Jimp object.

License

MIT

About

Merge multiple images into one single image

License:MIT License


Languages

Language:JavaScript 100.0%