# Image Concatenate

This function block is designed to concatenate multiple images either horizontally or vertically. It ensures that all images are of the same size by adding padding when necessary.

## 📥 Inputs <a href="#inputs" id="inputs"></a>

`Image List` A list of images to be concatenated together. The input can accept multiple images at once.

## 📤 Outputs <a href="#outputs" id="outputs"></a>

`Image Any` The output is a single image that results from the concatenation of the input images.

## 🕹️ Controls <a href="#controls" id="controls"></a>

`Relation` A dropdown selection that allows you to choose between horizontal and vertical concatenation of the images.

## 🎨 Features <a href="#features" id="features"></a>

`Dynamic Padding Adjustment` The block automatically adjusts images to ensure they all align properly by adding black padding where necessary.

`Flexible Concatenation Direction` Users can choose to concatenate images either horizontally or vertically, providing versatility in output structure.

## 📝 Usage Instructions <a href="#usage" id="usage"></a>

1. **Input Images**: Connect the images you wish to concatenate to the `Image List` input.
2. **Select Direction**: Choose whether you want the images to be combined `HORIZONTAL` or `VERTICAL` using the `Relation` dropdown.
3. **Evaluate**: Run the block to concatenate the images according to your selected method. The concatenated image will be available at the output.

## 📊 Evaluation <a href="#evaluation" id="evaluation"></a>

This function block evaluates the input image list and produces a new image that combines all provided images based on the specified direction.

## 💡 Tips and Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

<details>

<summary>Maintaining Aspect Ratios</summary>

When concatenating images, consider checking and adjusting their aspect ratios first. If images do not match, padding may affect the visual outcome.

</details>

<details>

<summary>Image Alignment</summary>

If images need to be verified for alignment, consider using `Check Area` before concatenating to ensure they visually match or are aligned correctly.

</details>

<details>

<summary>Previewing Before Concatenation</summary>

Before concatenating, consider using the `Show Image` function block to preview individual images. This can help in deciding which images to include.

</details>

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>Output Image Not Displaying Correctly</summary>

If the output image does not display as expected after concatenation, check the individual input images for size compatibility. Keep in mind heights or widths must match for proper concatenation.

</details>

<details>

<summary>Too Many Images Connected</summary>

Ensure that the number of images connected to the input does not exceed practical limits. While the block can handle multiple images, processing time might increase with larger lists.

</details>
