> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/image-transformations/operations/image-concatenate.md).

# Image Concatenate

This function block merges multiple images into a single image by placing them side-by-side (horizontal) or one after another (vertical). It automatically aligns images by adding borders when input images have different dimensions so you get a clean, single output image.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

* `Image List` مخرج دخل يقبل صورة واحدة أو أكثر ليتم دمجها (يدعم صور متعددة).

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

* `Image` مخرج يوفر الصورة المدمجة.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

* `Relation` قائمة منسدلة لاختيار اتجاه الدمج.
  * اختر بين الترتيب `HORIZONTAL` أو `VERTICAL`.

## 🎯 الميزات الرئيسية <a href="#features" id="features"></a>

* المحاذاة التلقائية: عند اختلاف عرض أو ارتفاع الصور الداخلة، يقوم البلوك بإضافة حدود لمطابقة الأحجام بحيث تصطف الصور بشكل صحيح.
* يدعم مدخلات متعددة: مرّر قائمة صور وسيُنتج البلوك صورة واحدة مدمجة.
* تبديل بسيط للاتجاه: بدّل بين الدمج الأفقي والعمودي باستخدام التحكم `Relation`.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

عند التنفيذ، يقرأ البلوك قائمة الصور المقدمة، ويتأكد من تطابق أبعاد كل صورة عن طريق إضافة حدود عند الحاجة، ثم يدمجها وفقًا لاختيار `Relation`. تُرسل الصورة الناتجة إلى مخرج `Image` للاستخدام في البلوكات التالية أو للعرض.

## 📝 الاستخدام <a href="#usage" id="usage"></a>

1. زوّد مدخل `Image List` بالصور — يمكنك توصيل عدة بلوكات منتجة للصور أو قائمة صور.
2. اختر التخطيط المطلوب من خلال قائمة `Relation`.
3. اطلع على النتيجة المدمجة من مخرج `Image` واستخدمها للعرض أو التسجيل أو المعالجة اللاحقة.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* إذا كنت تريد نتائج متسقة بدون حدود مرئية، استخدم `Image Resizer` أو `Image Resize` قبل هذا البلوك لجعل جميع الصور بنفس الحجم.
* للتحكم بلون الحشو أو إضافة هوامش مخصصة، قم بتحضير الصور باستخدام `Image Padding` أولاً، ثم دمجها.
* قم بقص المدخلات إلى المناطق الدقيقة التي تريد دمجها باستخدام `Image ROI Select` أو `Image ROI` قبل إدخالها هنا.
* استخدم `Show Image` لمعاينة النتيجة المدمجة بشكل تفاعلي.
* لحفظ أو تسجيل المخرج المدمج، قم بتوصيل مخرج `Image` إلى `Image Logger` أو `Image Write`.
* إذا كنت تريد تخطيطًا على شكل ملصقة مع حدود تشير إلى حالات OK/NOK، فكر في استخدام `Collage Images` كبديل أو كتتمة.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* حدود سوداء غير متوقعة: الصور لها نسب أبعاد مختلفة. إما تقبل الحدود، أو استخدم `Image Resizer` / `Image Padding` / `Image ROI Select` لمطابقة أحجام المدخلات.
* مخرج فارغ أو مفقود: تأكد من أن كل إدخال في `Image List` هو صورة صالحة. استخدم بلوك معاينة مثل `Show Image` للأعلى للتحقق من المدخلات.
* مخرج طويل جدًا أو عريض جدًا: اختر `VERTICAL` أو `HORIZONTAL` في `Relation` بالشكل المناسب أو قم بتغيير حجم المدخلات إلى أبعاد مناسبة قبل الدمج.