Minimum Circle

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

📥 المدخلات

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

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

📤 المخرجات

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

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

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

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

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

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

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

🎯 الميزات

• يُنتج صورة مرئية تظهر الدائرة المحيطة للتأكد البصري بسهولة.

• يعيد مخرجات عددية هندسية (Center, Radius) يمكن استخدامها في كتل لاحقة للقياس أو المنطق.

• خفيف وسريع—مناسب لخطوط أنابيب في الزمن الحقيقي عندما تتوفر المحيطات.

• يعمل مع أي بلوك ينتج Contour؛ لا يلزم معلمات إضافية.

📝 الاستخدام

1. زوّد مخرج Contour إلى مدخل Contour — عادةً ناتج من Find Contour أو مستخرج الشكل.

2. زوّد صورة إلى مدخل Image Any للعرض المرئي.

3. شغّل السيناريو؛ سيُخرج البلوك الصورة المشروحة وخصائص الدائرة.

💡 نصائح وحيل

• للحصول على محيطات، استخدم كتل مثل Find Contour أو Find Object قبل هذا البلوك.

• إذا كان المحيط غير منتظم أو مفصّل جدًا، استعمل Approximate Contour لتبسيط الشكل قبل إرساله هنا — قد يعطي ذلك دائرة محيطة أكثر معقولية على المحيطات المشوشة.

• اقتصاص منطقة الاهتمام باستخدام Image ROI Select أو Image ROI يسرّع المعالجة ويمنع محيطات غير ذات صلة.

• جهّز الصورة مسبقًا بـ Blur أو Image Threshold لتحسين جودة اكتشاف المحيطات في المراحل السابقة.

• قم بعرض أو تعليق النتائج النهائية باستخدام Draw Rectangle, Draw Result On Image, أو أرسل النتيجة إلى Show Image لعرض أكبر.

• استخدم المخرجات العددية (Center, Radius) مع كتل القياس أو المنطق (مثلاً للمقارنة بين الأحجام، تفعيل تنبيهات، أو حفظ القيم).

🛠️ استكشاف المشكلات وإصلاحها

• لا تظهر دائرة: تأكد من وجود Contour صالح. استخدم بلوكًا منتجًا للمحيط مثل Find Contour وتحقق أن المحيط ليس فارغًا.

• تبدو الدائرة كبيرة جدًا أو صغيرة جدًا: جرّب تبسيط Contour باستخدام Approximate Contour أو حسّن اكتشاف المحيط بتعديل المعالجة السابقة (مثل Image Threshold, Blur).

• نتائج غير متوقعة على صور مشوشة: اقتطع منطقة الاهتمام باستخدام Image ROI Select وتابع بتنقية الضوضاء أولًا.