> 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/get-dimension.md).

# Get Dimension

هذا البلوك يُرجع أبعاد صورة الإدخال على شكل قائمة أرقام. يكون مفيدًا عندما تحتاج أن تعرف عرض الصورة، ارتفاعها ومعلومات القنوات قبل تطبيق عمليات معالجة صور أخرى.

## 📥 المدخلات

`Image Any` هذا المدخل يقبل أي بيانات صورة من بلوكات أخرى.

## 📤 المخرجات

`Dimensions` يعيد أبعاد الصورة (مثال: height, width, channels) كقائمة من الأرقام.

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

لا يحتوي هذا البلوك على عناصر تحكم.

## 🎯 الميزات

* استرجاع سريع لمعلومات شكل الصورة لتوجيه خطوات المعالجة اللاحقة.
* يعمل مع الصور الملونة والرمادية؛ المخرجات تعكس صيغة شكل الصورة الممررة.

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

1. وصل بلوك ينتج صورة (كاميرا، محمل صورة loader أو بلوك معالجة) إلى مدخل `Image Any`.
2. اطلع على خرج `Dimensions` للحصول على معلومات شكل الصورة.
3. استخدم قيم الأبعاد لتكوين بلوكات أخرى أو للتحقق من أحجام الصور في السيناريو الخاص بك.

## 📊 التقييم

عند التنفيذ، يقوم هذا البلوك بفحص الصورة المتصلة ويخرج قائمة رقمية تصف أبعادها (مثل height, width, channels). إذا لم تُزوَّد صورة، فلن يُنتج البلوك قائمة أبعاد.

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

* استخدم `Load Image` أو بلوكات مدخل الكاميرا مثل `Camera USB` و`Camera IP (ONVIF)` كمصادر صورة للتحقق السريع من أحجام الصور الواردة.
* إذا رغبت بمعاينة الصورة قبل فحص الأبعاد، اربط بلوك `Show Image` بنفس مصدر الصورة.
* لقياس منطقة مقصوصة، وصل بلوك قص مثل `Image ROI` أو `Image ROI Select` قبل هذا البلوك — عندها سيعكس خرج `Dimensions` مساحة المنطقة المقصوصة.
* عند العمل مع صور كبيرة جدًا، فكّر بإرسال نسخة مُعاد تحجيمها باستخدام `Image Resize` أو `Image Resizer` قبل طلب الأبعاد لتسريع المعالجة اللاحقة.
* استخدم `Image Resolution and Channel Value` إذا أردت خرجة مفصّلة بعرض/ارتفاع/قنوات منفصلة أو معلومات قناة أعمق.

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

* لا يوجد خرج أو نتيجة فارغة: تأكد من توصيل مصدر صورة إلى مدخل `Image Any`.
* عدد عناصر غير متوقع في النتيجة: بعض الصور تكون رمادية (height, width) بينما الصور الملونة تتضمن عدد القنوات (height, width, channels). استخدم `Split Image` أو `Image Resolution and Channel Value` إن احتجت معلومات منفصلة عن القنوات.
* إذا كان من الممكن أن يكون الإدخال مفقودًا أحيانًا، استخدم بلوكات مثل `Is None` أو `Replace None` في المسار السابق لتوفير بيانات بديلة وتجنب الانقطاع.
