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

# Add Images

This function block combines two images by adding their pixel values together. It is a simple, fast way to merge brightness or overlay image contents, useful when you want a direct sum of two images rather than a blended average.

## 📥 المداخل

`Image Any` الصورة الأولى التي ستتم إضافتها.

`Image Any` الصورة الثانية التي ستتم إضافaması.

## 📤 المخارج

`Image Any` الصورة الناتجة بعد الجمع لكل بكسل (القيم محفوظة ضمن نطاق العرض الصحيح).

## 🕹️ الضوابط

يحتوي هذا block على no interactive controls.

## ⚙️ آلية العمل

* يقرأ الـ block الصورتين المرسلتين وينتج صورة جديدة بدمج قيم البكسل لكل بكسل من كلا المدخلين.
* تُحافظ قيم البكسل الناتجة داخل نطاق العرض الصالح حتى تظل الصورة قابلة للعرض.
* للحصول على أفضل نتائج، يجب أن تكون كلتا الصورتين بنفس الدقة وعدد القنوات (مثلاً كلتاهما RGB أو كلتاهما تدرج الرمادي). إذا اختلفتا، قم بتحضير الصور أولاً (انظر Tips and Tricks).

## ⭐ الميزات

* دمج بكسلي سريع جداً — مفيد لتراكب بسيط، تراكم السطوع، أو دمج طبقات بصرية.
* ينتج صورة واحدة يمكن عرضها أو معالجتها لاحقاً بواسطة blocks أخرى.
* يعمل مع أي صيغة صورة يدعمها النظام طالما أن المدخلات متوافقة.

## 📝 تعليمات الاستخدام

1. وصّل مصدر الصورة الأولى إلى مدخل `Image Any` الأول.
2. وصّل مصدر الصورة الثانية إلى مدخل `Image Any` الثاني.
3. اقرأ الصورة المدمجة من مخرج `Image Any` وأرسلها إلى عرض، تحليل أو blocks حفظ.

## 💡 نصائح وحيل

* إذا أردت مزجًا بوزن معين بدلاً من مجموع مباشر، استخدم block "Add Images Weighted".
* إذا كانت أحجام المدخلات مختلفة، استخدم "Image Resizer" أو "Image Resize" لمطابقة الأبعاد قبل الجمع. يمكن أيضاً استخدام "Image Padding" لمحاذاة الصور دون تغيير المقياس.
* لتجنب فقدان التفاصيل بسبب تشبع المناطق الساطعة (clipping)، جرّب "Normalize Image" أو "Contrast Optimization" بعد الجمع.
* استخدم "Blur" أو "Denoising" على المدخلات قبل الجمع إذا تسببت الضوضاء بآثار غير مرغوبة.
* إذا اختلفت القنوات (مثلاً إحداها grayscale والأخرى RGB)، استخدم "Split Image / Merge Channels" لتحويل أو تعديل القنوات لتتطابق.
* عاين النتائج باستخدام "Show Image" واحفظ المخرجات باستخدام "Image Logger" أو "Image Write" لأغراض السجل.

## 🛠️ مشكلات شائعة والحلول

* المشكلة: المخرج يبدو مُعرَّضًا بشدة أو مقطوعًا (overexposed / clipped).\
  الحل: استخدم "Add Images Weighted" للتحكم في مساهمة كل صورة، أو شغّل "Normalize Image" / "Contrast Optimization" على النتيجة.
* المشكلة: المدخلات لها أحجام أو نسب أبعاد مختلفة.\
  الحل: طابق الأحجام باستخدام "Image Resizer" أو "Image Resize" قبل توصيلها بهذا block.
* المشكلة: عدم تطابق القنوات (RGB مقابل grayscale).\
  الحل: حوّل القنوات باستخدام "Split Image" و "Merge Channels" أو تأكد من أن كلا المصدرين يعطيان نفس صيغة القنوات.
* المشكلة: ضوضاء أو تشويش غير متوقع بعد الجمع.\
  الحل: طبق "Blur" أو "Denoising" على المدخلات قبل الجمع؛ وفكّر في ضبط التعريض على مصادر الكاميرا أو إضافة خطوات معالجة مسبقة.
