Normalize Image

تقوم هذه الدالة بإعادة تحجيم قيم بكسل الصورة باستخدام طرق تطبيع قابلة للاختيار لتحسين العرض أو ضبط النطاق الديناميكي. تدعم أيضاً القص (clipping) استنادًا إلى إحصائيات الصورة لتقليل تأثير القيم الشاذة.

📥 المدخلات

Reference الصورة الأساسية التي سيتم تطبيعها. (مأخذ إدخال)

Second Image صورة اختيارية تُستخدم لحساب الإحصائيات الخاصة بالتطبيع. إذا تم توصيلها، تُستخدم إحصائياتها بدلاً من إحصائيات Reference. (مأخذ إدخال)

📤 المخرجات

Image Any الصورة بعد التطبيع جاهزة للمعالجة اللاحقة أو العرض. (مأخذ إخراج)

🕹️ عناصر التحكم

Morph Type اختر طريقة التطبيع. الخيارات الشائعة تتضمن:

• NORM_MINMAX تعيد مقياس قيم البكسل إلى نطاق محدد للعرض.

• NORM_INF تقيد القيم بالنسبة إلى القيمة العظمى، مفيد لتعديل النطاق الديناميكي.

Pixel Range حدد نطاق القيم المستهدف لبيكسلات الخرج باستخدام شريط نطاق أفقي. يتحكم هذا بالحد الأدنى والحد الأقصى بعد التطبيع.

Clip Intensity ضبط مقدار القص حول المتوسط (يعبر عنه بنسبة). القيم الأعلى تقلل من القيم المتطرفة عن طريق قص القيم خارج المتوسط ± (clip × الانحراف المعياري).

⚙️ آلية التشغيل

• عند التشغيل، يقرأ البلوك إعدادات Morph Type وPixel Range وClip Intensity ويطبق التطبيع على صورة Reference.

• إذا كانت Second Image متصلة، تُستخدم المتوسط والانحراف المعياري لتلك الصورة لتحديد نطاق القص؛ وإلا تُستخدم إحصائيات صورة Reference.

• يقوم البلوك أولاً بقص القيم الشديدة حول المتوسط وفقًا لقيمة Clip Intensity، ثم يقوم بترجمة قيم البكسل إلى Pixel Range المختار باستخدام طريقة التطبيع المحددة لإنتاج صورة الإخراج.

🎨 الميزات

• اختيار سريع بين مقياس مناسب للعرض (NORM_MINMAX) ومقياس مقيد بالقيمة العظمى (NORM_INF).

• قص قابل للتعديل لتقليل تأثير القيم المتطرفة أو البكسلات المشوشة.

• خيار استخدام صورة منفصلة لإحصاءات التطبيع، مما يتيح تطبيعًا متسقًا عبر صور متعددة أو تدفقات كاميرا.

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

1. وصل الصورة التي تريد تطبيعها إلى مدخل Reference.

2. اختياريًا، وصل صورة ثابتة أو عينة خلفية إلى مدخل Second Image لاستخدام إحصاءاتها.

3. اختر Morph Type المناسب لهدفك:

   • استخدم NORM_MINMAX لتعيين نطاق عرض صريح.

   • استخدم NORM_INF عند الرغبة في التقييد بالقيم العظمى.

4. اضبط Pixel Range لتحديد قيم min/max في الإخراج.

5. اضبط Clip Intensity للحد من تأثير القيم المتطرفة قبل التطبيع.

6. قم بتغذية الناتج Image Any إلى بلوكات العرض أو المعالجة اللاحقة.

💡 نصائح وحيل

• إذا كانت الصور المدخلة كبيرة جدًا، أضف Image Resizer قبل هذا البلوك لتسريع معاينات العمل.

• استخدم Denoising أو Blur قبل التطبيع لتقليل القص الناتج عن الضوضاء والحصول على إحصائيات أكثر استقرارًا.

• لتحسين التباين المدفوع بالهيستوجرام، جرب Auto Contrast أو Contrast Optimization بعد التطبيع لتحسين المظهر البصري.

• لمعاينة النتائج بصريًا، وصل الإخراج إلى Show Image أو احفظ أمثلة باستخدام Image Logger / Image Write.

• عند التحضير لمهام الكشف، طبّع الصور بشكل متسق عبر الإطارات عن طريق تزويد Second Image بصورة ممثلة (مثل عينة خلفية) ليصبح الكشف اللاحق (مثل Find Object أو Object Detection) أقل حساسية لتغيرات الإضاءة.

🛠️ استكشاف الأخطاء وإصلاحها

• إذا بدا الإخراج باهتًا أو مقصوصًا، قلل Clip Intensity أو وسع Pixel Range.

• إذا بدا التطبيع غير متسق عبر الإطارات، قدّم صورة ثابتة إلى Second Image ليتم استخدام نفس المرجع الإحصائي في كل مرة.

• إذا لم تظهر أي صورة، تأكد من توصيل صورة صالحة إلى Reference واعرض المعاينة باستخدام Show Image.