> 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/collage-images.md).

# Collage Images

تقوم هذه الدالة بإنشاء صورة مركّبة واحدة (collage) من عدة صور مدخلة. إذا تم تزويدها بقائمة أعلام متطابقة (OK/NOK)، يضيف التركيب حدوداً ملونة لكل بلاطة لتوضيح الحالة.

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

* `Image List` قائمة الصور التي سيتم دمجها في التركيب (يمكن أن تكون الصور بأحجام مختلفة).
* `Flag List` قائمة اختيارية من أعلام منطقية أو حالات (OK/NOK) تطابق كل صورة في `Image List`. عند توفيرها، تعرض البلاطات حدوداً ملونة تشير إلى حالة العلم.

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

* `Collaged Image` الصورة الناتجة المجمعة من قائمة المدخلات.

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

* `Select Image Size (Pixel)` استخدم هذا شريط التمرير لتعيين حجم البلاطة المستخدم في تخطيط التركيب. القيم الأكبر تنتج بلاطات أكبر وصورة تركيب نهائية أضخم.

## 🎨 الميزات <a href="#features" id="features"></a>

* دمج سهل لعدة صور في معاينة واحدة مناسبة للتقارير، لوحات المعلومات، أو الفحص السريع.
* دعم أعلام اختياري لوضع علامة بصرية على كل بلاطة كـ OK أو NOK باستخدام الحدود.
* حجم بلاطة قابل للتعديل لموازنة التفاصيل وحجم التركيب النهائي.
* يقبل مصادر صور مختلطة (إطارات كاميرا، قصاصات معالجة، صور محفوظة).

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

عند التشغيل، يقرأ الكتلة `Image List` والمجموعة الاختيارية `Flag List`. يعيد تحجيم الصور أو يقطعها حسب قيمة `Select Image Size (Pixel)` ويضعها في شبكة. إذا كانت الأعلام متوفرة وتطابق عدد الصور، تحصل كل بلاطة على حدود ملونة تشير إلى حالة OK/NOK. تُصدَر الصورة المجمعة النهائية من مخرج `Collaged Image`.

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

1. جهّز الصور التي تريد دمجها ومررها إلى مدخل `Image List`.
2. اختياريًا قدّم `Flag List` متماثلة الطول لإضافة حدود حالة لكل بلاطة.
3. عدّل قيمة `Select Image Size (Pixel)` لتغيير حجم البلاطة بحسب وضوح العرض أو التكثيف المطلوب.
4. وصل مخرج `Collaged Image` إلى بلاك عرض مثل `Show Image` أو إلى بلاك حفظ لفحص أو تخزين النتيجة.

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

* قم بتوحيد أحجام المدخلات لمزدوجات أكثر جمالية: استخدم `Image Resize` أو `Image Resizer` قبل إدخال الصور في `Image List`.
* إذا رغبت بجمع مناطق متعددة مقطوعة من مصدر واحد، استخدم `Image ROI Select Multi` لبناء `Image List`.
* أنشئ الأعلام تلقائيًا عن طريق دمج كتل الكشف مثل `Mask Detection`, `Object Detection`, أو `Object Detection - Custom`. استخدم نتائج الكشف (منطق OK/NOK) لبناء `Flag List` للفحص البصري.
* معاينة التركيب النهائي تفاعليًا بربط المخرج إلى `Show Image`.
* احفظ التراكيب تلقائيًا باستخدام `Multi Image Write` أو سجّلها عبر `Image Logger` لتتبّع الأحداث.
* عند استخدام عدد كبير من الصور، قلّل قيمة `Select Image Size (Pixel)` للحفاظ على حجم التركيب ضمن حدود العرض أو حجم الملف.

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

* إذا بدت الحدود مفقودة أو غير صحيحة، تأكد من أن طول `Flag List` يساوي طول `Image List`.
* إذا بدت الصور مشوهة أو مقطوعة بشكل غير متوقع، أضف خطوة `Image Resize` لتوحيد نسب العرض/الارتفاع قبل إنشاء التركيب.
* إذا كان التركيب كبيرًا جدًا للعرض أو الحفظ، خفّض قيمة `Select Image Size (Pixel)`.