Introduction to ‘merge-img’ Library

The merge-img library is a powerful Python library designed for merging multiple images into a single image seamlessly. It offers a wide range of functionalities that make the image processing task simpler and more efficient.

Getting Started

To install merge-img, simply use pip:

  pip install merge-img

API Examples

Below are some useful API explanations with code snippets provided for your reference:

1. Merging Images Horizontally

To merge images horizontally:

  
    from merge_img import MergeImage

    img1 = 'path/to/image1.jpg'
    img2 = 'path/to/image2.jpg'
    output_path = 'path/to/output.jpg'
    
    merger = MergeImage()
    merger.horizontal([img1, img2], output_path)
  

2. Merging Images Vertically

To merge images vertically:

  
    from merge_img import MergeImage

    img1 = 'path/to/image1.jpg'
    img2 = 'path/to/image2.jpg'
    output_path = 'path/to/output.jpg'
    
    merger = MergeImage()
    merger.vertical([img1, img2], output_path)
  

3. Merging Images in a Custom Layout

Using custom rows and columns:

  
    from merge_img import MergeImage

    images = ['path/to/image1.jpg', 'path/to/image2.jpg', 'path/to/image3.jpg', 'path/to/image4.jpg']
    output_path = 'path/to/output.jpg'
    
    merger = MergeImage()
    layout = [(0, 0), (0, 1), (1, 0), (1, 1)]  # 2x2 grid
    merger.custom(images, layout, output_path)
  

Additional Features

The merge-img library also allows setting borders, adjusting padding, and more.

4. Adding Borders

You can add borders to the images:

  
    from merge_img import MergeImage

    img1 = 'path/to/image1.jpg'
    img2 = 'path/to/image2.jpg'
    output_path = 'path/to/output.jpg'
    
    merger = MergeImage()
    merger.horizontal([img1, img2], output_path, border={"width": 5, "color": (255, 0, 0)})
  

5. Adjusting Padding

To adjust the padding between merged images:

  
    from merge_img import MergeImage

    img1 = 'path/to/image1.jpg'
    img2 = 'path/to/image2.jpg'
    output_path = 'path/to/output.jpg'
    
    merger = MergeImage()
    merger.horizontal([img1, img2], output_path, padding=10)
  

App Example

Here is an example of an application that uses the merge-img library:

  
    from flask import Flask, request, send_file
    from merge_img import MergeImage
    import os

    app = Flask(__name__)
    
    @app.route('/merge', methods=['POST'])
    def merge_images():
        images = request.files.getlist('images')
        output_path = ' merged_image.jpg'
        merger = MergeImage()
        merger.horizontal([image.filename for image in images], output_path)
        return send_file(output_path, as_attachment=True)

    if __name__ == '__main__':
        app.run(debug=True)
  

Using the above Flask app, you can post multiple images to the ‘/merge’ endpoint, which will merge the images and return the combined image file to the user.

Hash: 3cba4a7b5b53872100f271f88929174eb4d5ceefcde9540d510f1d15a38b9bfb