> 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/image-resolution-and-channel-value.md).

# Image Resolution and Channel Value

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

## 📥 المدخلات

`Image Any` — مأخذ إدخال الصورة. زوّد أي صورة (ملونة أو رمادية) للتحليل.

## 📤 المخرجات

`Width` — عرض الصورة المدخلة بالبكسل (قيمة عددية).

`Height` — ارتفاع الصورة المدخلة بالبكسل (قيمة عددية).

`Channel` — عدد القنوات في الصورة (مثل 1 للصورة الرمادية، 3 لـ RGB).

## 🕹️ الضوابط

`Resolution` — تسمية عرضية على البلوك تعرض نصاً موجزاً يحتوي على العرض والارتفاع وعدد القنوات لسهولة الاطلاع السريع.

## 🎯 الميزات

* استخراج بيانات الميتاداتا بسرعة: يعيد فوراً العرض والارتفاع وعدد القنوات عند وجود صورة على مأخذ الإدخال.
* وعي بنوعية الصورة (رمادية/ملونة): يتعرف على الصور ذات القناة الواحدة والصور متعددة القنوات ويبلغ عن عدد القنوات المناسبة.
* ملاحظات بصرية: تسمية `Resolution` على البلوك تعرض النتيجة الحالية للمراجعة السريعة.

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

عند تنفيذ هذا البلوك، يقوم بفحص الصورة المرسلة إلى مأخذ `Image Any`، يحدد أبعاد البكسل وعدد القنوات، يحدث تسمية `Resolution` على البلوك، ثم يمرر القيم الرقمية عبر مخارج `Width`, `Height`, و`Channel` حتى تتمكن البلوكات التالية من استخدامها.

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

* وصل أي بلوك يولد صورة إلى مأخذ `Image Any` (مثل `Camera USB`, `Camera IP (ONVIF)` أو `Load Image`).
* اطلع على تسمية `Resolution` للحصول على ملخص سريع.
* استخدم المخرجات الرقمية `Width`, `Height` و`Channel` لاتخاذ قرارات منطقية، أو لاختيارات المعالجة المسبقة، أو لعرض المعلومات في بلوكات أخرى.

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

* لفحص الصورة بصرياً أثناء قراءة الأبعاد، وصل نفس مصدر الصورة إلى `Show Image` لعرض الإطارات أثناء قياس الأبعاد.
* إذا كنت تحتاج قياس منطقة محددة فقط، استخدم `Image ROI Select` قبل هذا البلوك لقياس دقة المنطقة المقتطعة بدل الصورة الكاملة.
* لتفقد معلومات الألوان بشكل أعمق، اجمع هذا البلوك مع `Split Image` لفصل القنوات أو مع `Merge Channels` بعد التعديلات المخصصة.
* استخدم `Image Memory` عند العمل مع صورة اختبار ثابتة حتى تبقى القيم المبلّغ عنها مستقرة أثناء ضبط خطوات المعالجة الأخرى.

(تلميح) اجمع هذا البلوك في بداية سلسلة المعالجة لاتخاذ قرارات متكيفة (مثل اختيار خوارزمية مناسبة أو استراتيجية تغيير الحجم) بناءً على حجم الصورة الفعلي وعدد القنوات.

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

* لا توجد بيانات مخرجات: تأكد من توصيل بلوك يولد الصور إلى مأخذ `Image Any` وأنه يزوّد صوراً فعّالة.
* عدد قنوات غير متوقع: بعض الصور الرمادية هي قناة واحدة بينما الصور الملونة ثلاث قنوات. إن كنت بحاجة إلى تنسيق قنوات مختلف، استخدم `Split Image` و`Merge Channels` أو بلوكات تحويل الألوان قبل هذا البلوك.
* أحجام صور كبيرة جداً تبطئ التدفق: غيّر الحجم في البلوكات السابقة باستخدام `Image Resizer` لتقليل حمل المعالجة قبل إرسال الصور إلى بلوكات ثقيلة الحساب.