Mallabe Images icon

Mallabe Images

Mallabe Images is an automation toolchain that allows you to process images, resize, crop and apply other manipulations on images on the fly.

Actions9

Overview

This node, part of the "Mallabe Images" toolchain, allows users to join or combine two images into a single image. It supports joining images either vertically or horizontally, with options for alignment, background color, and spacing (offset) between the images. This operation is useful in scenarios where you want to create composite images from separate sources, such as combining product photos side-by-side or stacking images for comparison.

Practical examples:

  • Creating a vertical collage of two event photos.
  • Combining a logo and a banner image horizontally for marketing materials.
  • Merging before-and-after images with a customizable gap and background color.

Properties

Name Meaning
First Image URL Public URL of the first image file to join
Second Image URL Public URL of the second image file to join
Direction Direction of the merged image: Vertical or Horizontal
Images Alignment Alignment of images when sizes differ: Start, Center, or End
Background Color Hex color code for the background behind the images
Offset Number of pixels as space between the two images
Download Image? Whether to download the resulting image binary data (true) or return a link (false)
Put Output File In Field The name of the output field to put the binary file data in (used only if downloading the image)
Webhook URL (Advanced) Optional URL to send a webhook with the data of the operation

Output

The node outputs JSON data containing information about the joined image. If the "Download Image?" property is set to true, it also outputs the binary data of the combined image under the specified output field name.

  • json: Contains metadata and the URL of the newly created joined image.
  • binary (optional): Contains the actual image file data if downloading is enabled.

Dependencies

  • Requires an API key credential for the Mallabe Images service to authenticate requests.
  • Relies on external Mallabe Images API endpoints to perform the image joining operation.
  • Network access to the public URLs of the input images is necessary.
  • Optional webhook URL can be configured to receive asynchronous notifications.

Troubleshooting

  • Common issues:

    • Invalid or inaccessible image URLs may cause the operation to fail.
    • Protected or private URLs that require authentication cannot be processed.
    • Incorrect hex color codes for background color might lead to unexpected backgrounds.
    • Large images or slow network connections may increase processing time.

  • Error messages:

    • Errors related to image fetching usually indicate URL problems; verify the URLs are publicly accessible.
    • API authentication errors suggest missing or invalid API credentials.
    • If the node fails silently or returns empty results, check the "Download Image?" setting and output field configuration.

Links and References

Discussion