Merge images

Overview

This node combines several input images into a single composite frame. It's useful for creating multi-camera views on a dashboard or preparing data for analysis across multiple sensors.

Use Merge images when:

• You want to display multiple camera feeds in a single widget.
• You need to pass multiple related images into a single AI model node.

⚠️ Warning

All input images must have the same aspect ratio for the merging process to work correctly.

Inputs

Name	Type	Description
image_01...image_N	image	The multiple input images to be merged.

Outputs

Name	Type	Description
image	image	The final composite image.

Parameters

Parameter	Default	Valid values	Tunable
Number of inputs	2	2 – 10	❌
Layout	HORIZONTAL	HORIZONTAL, VERTICAL, QUAD	❌

Number of inputs

The total number of input images to combine.

Layout

Determines the layout of the merged images.

• Horizontal: Arranges the images in a horizontal (left-to-right) pattern.
• Vertical: Arranges the images in a vertical (top-to-bottom) pattern.
• Quad: Arranges the images in a 2x2 square pattern. This option is only possible for four images.

Example

Multi-angle inspection

A system with four cameras inspecting a part from different angles merges all feeds into one view for easy monitoring.

Configuration:

• Number of inputs: 4
• Layout: QUAD

Result: A single output image shows all four perspectives in a four-pane grid on one widget.

Related links

Reference:

• Resize Image — resizing inputs before merging
• Crop Image — trimming images before they are combined