> 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/detections-shapes/shape-analysis/hull-convex.md).

# Hull Convex

يقوم هذا البلوك الوظيفي بحساب محيط محدب (convex hull) يحيط بالـ contour المُزوَّد ويعيد نتائج بصرية ورقمية مفيدة لتحليل الشكل.

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

`Image` الصورة المصدرية المستخدمة للعرض والقياسات.

`Contour` الكنتور (الشكل) المدخل الذي سيتم حساب المحيط المحدب له.

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

`Image` الصورة المصدرية بعد وضع التعليقات التوضيحية (annotated) التي تُظهر الكنتور الأصلي والمحيط المحدب.

`Contour` الكنتور الناتج للمحيط المحدب معاد كشكّل (shape).

`Center` مركز الكتلة (centroid) للمحيط المحدب (x, y).

`Area` مساحة المحيط المحدب.

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

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

## 🎯 ماذا يفعل <a href="#features" id="features"></a>

* يحسب محيطًا محدبًا يغطي الكنتور المزوَّد.
* يرسم كل من الكنتور الأصلي والمحيط المحدب على الصورة لتسهيل المقارنة البصرية.
* يحسب مساحة الـ hull وإحداثيات مركز الكتلة لاستخدامها في قياسات لاحقة أو منطق تحكم.
* يُرجع مخرجات بصرية مع التعليقات التوضيحية بالإضافة إلى المخرجات المهيكلة للشكل والقياسات للمعالجة اللاحقة.

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

1. أدخل الصورة الأصلية في مدخل `Image` ليتمكن البلوك من إنتاج نتيجة بصرية مع التعليقات التوضيحية.
2. أدخل كانتور مكتشف في مدخل `Contour` لحساب المحيط المحدب الخاص به.
3. استخدم `Image` المُعلّم لمعاينة الفرق بين الكنتور والمحيط المحدب، واستعن بـ `Contour` و `Center` و `Area` للقياسات أو الفلترة أو التقارير.

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

عند التشغيل، يقوم البلوك بفحص الكنتور المزوَّد، ينتج كنتور المحيط المحدب، يعلّم الصورة بكلتا الشكلين، يحسب مركز الكتلة والمساحة، ويُخرج هذه النتائج الأربعة: صورة معنونة، كنتور الـ hull، نقطة المركز، والمساحة.

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

* إذا لم يكن لديك كانتور بعد، استخدم البلوك `Find Contour` أو `Find Object` للحصول على كنتورات من الصورة قبل تمريرها لهذا البلوك.
* لتبسيط الكنتورات المعقدة قبل حساب الـ hull، فكر في استخدام `Approximate Contour` لتقليل عدد النقاط وتحسين الأداء.
* استخدم `Minimum Rectangle`، `Minimum Circle` أو `Minimum Ellipse` بعد هذا البلوك إذا احتجت أشكال احتوائية بديلة أو واصفات هندسية إضافية.
* حضّر الصورة مسبقًا باستخدام `Image Threshold` أو `Image Adaptive Threshold` أو `Blur` للحصول على كنتورات أنظف وزيادة موثوقية حساب الـ hull.
* ركّز التحليل أو اقتطع المنطقة باستخدام `Image ROI`، `Image ROI Select` أو `Image ROI Polygon` بحيث يستهدف استخراج الكنتور وحساب الـ hull المنطقة ذات الاهتمام.
* اعرض النتائج في نافذة أكبر باستخدام `Show Image` واحفظ الإطارات المهمة باستخدام `Image Logger` أو `Image Write` للتوثيق أو المراجعة لاحقًا.

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

* إذا كان الإخراج `Contour` فارغًا أو كانت الـ `Area` صفرًا: تأكد من أن مدخل `Contour` صالح ويحتوي على نقاط كافية. استخدم بلوكات توليد الكنتور (`Find Contour`, `Find Object`) وتحقق من مخرجاتها.
* إذا بدت التعليقات التوضيحية غير متوافقة بعد تغيير قياس الصورة: تأكد من استخدام نفس أبعاد الصورة عبر كامل المسار (استخدم `Image Resize` أو `Image Resizer` بشكل متسق).
* إذا كانت أشكال الخلفية غير المرغوب فيها تنتج محيطات محدبة كبيرة: جرّب المعالجة المسبقة (thresholding, blurring) واستخدم بلوكات ROI للتركيز على الكائن المطلوب.