> 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/analysis/mean-value-of-image.md).

# Mean Value of Image

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

* `Image Any` الصورة التي سيُحسب لها متوسط قيمة البكسل.

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

* `Mean Value` متوسط شدة البكسل المحسوب (مقرب)، ضمن النطاق 0–255.

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

* `Mean value` عرض صغير داخل البلوك يُظهر المتوسط الحالي المحسوب.\
  هذا البلوك لا يحتوي على عناصر تحكم قابلة للتعديل من قبل المستخدم بخلاف هذا العرض.

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

* حساب سريع لمتوسط شدة البكسلات لأي نوع صورة.
* تغذية بصرية حية عبر عرض القيمة داخل البلوك.
* يعمل مع الصور الملونة أو التدرج الرمادي عن طريق أخذ متوسط جميع القنوات/البكسلات إلى قيمة واحدة.

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

1. قم بتوصيل أي بلوك يقوم بإنتاج صورة إلى مدخل `Image Any`.
2. شغّل السيناريو. سيحسب البلوك المتوسط ويحدث عرض `Mean value` داخل البلوك.
3. اقرأ النتيجة الرقمية من مخرج `Mean Value` لاستخدامها في منطق لاحق أو للتسجيل.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التشغيل، يحسب البلوك المتوسط عبر جميع البكسلات (والقنوات) في الصورة المدخلة ويعيد قيمة رقمية (مقربة) تمثل السطوع الإجمالي/متوسط الشدة.

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

* استخدم `Blur` قبل هذا البلوك لتقليل تأثير التذبذب الضوضائي الصغير على المتوسط.
* استخدم `Image Threshold` أو `Apply Mask` لحساب المتوسط فقط على مناطق المقدمة بدلاً من الصورة كاملة.
* استخدم `Image ROI` أو `Image ROI Select` لتقييد الحساب إلى منطقة اهتمام (لاختبارات سطوع محلية).
* قلّل تكلفة المعالجة على الصور الكبيرة بإضافة `Image Resizer` قبل هذا البلوك.
* استخدم `Show Image` مع هذا البلوك للتحقق بصريًا من الإطار الذي تشير إليه قيمة المتوسط.
* اجمع مع `Image Memory` لتجميد عينة صورة وتحليل نفس الإطار مرارًا لمقارنات مستقرة.

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

* إذا كانت قيمة `Mean Value` غير متوقعة، تحقق من الصورة المدخلة باستخدام `Show Image` للتأكد من المصدر والمحتوى الصحيحين.
* إذا لم تظهر أي قيمة، تأكد من أن البلوك المنتج للصورة يوفّر بيانات صورة صالحة. البلوك يتوقع مدخلاً من نوع صورة.
* للحصول على قراءات غير متسقة، جرّب التمليس باستخدام `Blur` أو اقتصاص منطقة الاهتمام باستخدام `Image ROI Select` قبل حساب المتوسط.