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

# Subtract Images

هذا الدالة تقوم بحساب الفرق بكسل-ببكسل بين صورتين لتسليط الضوء على التغييرات أو العيوب. مفيدة لمهام المقارنة مثل اكتشاف الانحرافات عن مرجع، الفحص البصري وتحليل الحركة/التغير.

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

`Actual Image`\
مقبس الإدخال — الصورة المصدر التي سيتم مقارنتها.

`Reference Image`\
مقبس الإدخال — الصورة المرجعية التي سيتم طرحها من الصورة الفعلية (الخط الأساسي أو المرجع).

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

`Difference Image`\
مقبس المخرج — الصورة الناتجة التي توضح الفرق بكسل-ببكسل بين المدخلتين.

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

لا يحتوي هذا البلوق على عناصر تحكم أو ويدجت مرئية للمستخدم.

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

* يُنتج صورة فرق مرئية تُبرز التغيرات على مستوى البكسل بين صورتين لهما نفس الأبعاد.
* يعمل مع الصور الملونة أو الرمادية (كلا المدخلين يجب أن يكونا بنفس الأبعاد).
* عملية بسيطة وسريعة، مناسبة كخطوة معالجة أولية لعمليات الكشف أو التسجيل التالية.

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

عندما يوفر كلا مقبسي الإدخال صورًا، يقوم البلوق بإنتاج `Difference Image` عن طريق إجراء طرح بكسل-ببكسل للمرجع من الصورة الفعلية. يتطلب البلوق أن تكون أحجام الصورتين متطابقة؛ إذا اختلفت الأحجام فسيتم الإبلاغ عن خطأ. يمكن توجيه ناتج الفرق إلى وحدات عرض، أو تحديد العتبة، أو عدّ ليفسر النتائج.

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

1. وصل صورة المصدر إلى مقبس الإدخال `Actual Image`.
2. وصل صورة الخط الأساس أو المرجعية إلى مقبس الإدخال `Reference Image`.
3. تأكد من أن الصورتين لهما نفس الحجم. إذا لم يكن كذلك، أدرج البلوق `Image Resize` قبل هذا البلوق.
4. استخدم مخرج `Difference Image` للعرض أو للمعالجة اللاحقة.

أمثلة على سير العمل الشائعة:

* الفحص البصري: وصل `Difference Image` إلى `Show Image` لمعاينة التغيرات.
* الكشف الثنائي (Binary): أدخل `Difference Image` في `Image Threshold` لإنشاء قناع للمناطق المتغيرة.
* القياس الكمي: مرّر القناع الناتج بعد العتبة إلى `Non-zero of Image` لعد البكسلات المتغيرة.
* التسجيل: احفظ النتائج باستخدام `Image Logger` أو `Image Write` للاحتفاظ بسجلات.

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

* تأكد من محاذاة الصور ومطابقة الدقة قبل الطرح. استخدم `Image Resize` أو وحدات المحاذاة الهندسية إذا لزم الأمر.
* لجعل الفروق الطفيفة أكثر وضوحًا، طبق `Contrast Optimization` أو `Normalize Image` على `Difference Image` قبل العرض.
* قم بتحويل الفرق إلى قناع ثنائي باستخدام `Image Threshold` لعزل التغييرات ذات المغزى. وبدمجه مع `Non-zero of Image` ستحصل على مقياس عددي للتغيير.
* للفحص السريع أثناء التطوير، وصل المخرج إلى `Show Image`. للعمليات الآلية، احفظ النتائج بواسطة `Image Logger` أو `Image Write`.
* إذا كنت تتوقع مخرجات بقناة مفردة، تحقق من تنسيقات قنوات المدخلات (رمادية مقابل RGB) في المراحل السابقة وقم بتحويلها بشكل متسق.

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

* أحجام الصور غير المطابقة\
  تأكد من أن كلا المدخلين يتشاركان العرض والارتفاع نفسه. استخدم بلوق `Image Resize` لإعادة أخذ عينة إحدى الصور.
* فرق قليل جدًا أو غير مرئي\
  طبق `Contrast Optimization` أو `Normalize Image` لتضخيم التغيرات الصغيرة، أو استخدم `Image Threshold` لإنشاء قناع ثنائي.
* ألوان أو قنوات غير متوقعة\
  تأكد من أن كلا المدخلين في نفس فضاء الألوان (كلاهما رمادي أو كلاهما RGB) قبل توصيلهما.
* الحاجة إلى مقياس عددي للتغيير\
  بعد تطبيق العتبة على الفرق، أرسل القناع إلى `Non-zero of Image` للحصول على عدد البكسلات المتغيرة.