> 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/minimum-circle.md).

# Minimum Circle

تحدد هذه الدالة أصغر دائرة تحيط بشكل محدد (`Contour`) وتقوم برسمها على الصورة المعطاة. تُعيد الدالة مركز الدائرة ونصف القطر، بالإضافة إلى صورة مرئية توضح النتيجة. مفيدة لتقدير حجم أو موضع كائن، أو لإجراء قياسات بسيطة تعتمد على الشكل.

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

`Image Any`\
الصورة المستخدمة كمسطح رسم ومرجع مرئي للنتيجة. ستُعاد نسخة من هذه الصورة مع الدائرة المرسومة فوقها.

`Contour`\
الشكل (المحيط) الذي يحدد الكائن المراد إحاطته بالدائرة. عادةً ما يأتي هذا من كتلة اكتشاف المحيطات أو استخراج الأشكال.

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

`Image`\
نسخة من الصورة الداخلة مع رسم أصغر دائرة محيطة عليها.

`Center`\
موقع مركز الدائرة المحيطة (x, y). استخدم هذه القيمة للمحاذاة أو القياسات أو العمليات الهندسية اللاحقة.

`Radius`\
نصف قطر الدائرة المحيطة. مفيد لتقدير الحجم أو وضع حدود أو تفعيل منطق لاحق.

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

لا يحتوي هذا البلوك على عناصر تحكم تفاعلية—فقط قدّم مآخذ الإدخال المطلوبة وسيُنتج المخرجات عند التشغيل.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

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

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

* يُنتج صورة مرئية تظهر الدائرة المحيطة للتأكد البصري بسهولة.
* يعيد مخرجات عددية هندسية (`Center`, `Radius`) يمكن استخدامها في كتل لاحقة للقياس أو المنطق.
* خفيف وسريع—مناسب لخطوط أنابيب في الزمن الحقيقي عندما تتوفر المحيطات.
* يعمل مع أي بلوك ينتج `Contour`؛ لا يلزم معلمات إضافية.

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

1. زوّد مخرج `Contour` إلى مدخل `Contour` — عادةً ناتج من `Find Contour` أو مستخرج الشكل.
2. زوّد صورة إلى مدخل `Image Any` للعرض المرئي.
3. شغّل السيناريو؛ سيُخرج البلوك الصورة المشروحة وخصائص الدائرة.

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

* للحصول على محيطات، استخدم كتل مثل `Find Contour` أو `Find Object` قبل هذا البلوك.
* إذا كان المحيط غير منتظم أو مفصّل جدًا، استعمل `Approximate Contour` لتبسيط الشكل قبل إرساله هنا — قد يعطي ذلك دائرة محيطة أكثر معقولية على المحيطات المشوشة.
* اقتصاص منطقة الاهتمام باستخدام `Image ROI Select` أو `Image ROI` يسرّع المعالجة ويمنع محيطات غير ذات صلة.
* جهّز الصورة مسبقًا بـ `Blur` أو `Image Threshold` لتحسين جودة اكتشاف المحيطات في المراحل السابقة.
* قم بعرض أو تعليق النتائج النهائية باستخدام `Draw Rectangle`, `Draw Result On Image`, أو أرسل النتيجة إلى `Show Image` لعرض أكبر.
* استخدم المخرجات العددية (`Center`, `Radius`) مع كتل القياس أو المنطق (مثلاً للمقارنة بين الأحجام، تفعيل تنبيهات، أو حفظ القيم).

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

* لا تظهر دائرة: تأكد من وجود `Contour` صالح. استخدم بلوكًا منتجًا للمحيط مثل `Find Contour` وتحقق أن المحيط ليس فارغًا.
* تبدو الدائرة كبيرة جدًا أو صغيرة جدًا: جرّب تبسيط `Contour` باستخدام `Approximate Contour` أو حسّن اكتشاف المحيط بتعديل المعالجة السابقة (مثل `Image Threshold`, `Blur`).
* نتائج غير متوقعة على صور مشوشة: اقتطع منطقة الاهتمام باستخدام `Image ROI Select` وتابع بتنقية الضوضاء أولًا.