> 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-rotated-rectangle.md).

# Minimum Rotated Rectangle

هذه الدالة تحسب أصغر مستطيل مدور (مستطيل بزاوية) يحيط بشكلٍ معين (contour) في الصورة. مفيدة لقياس حجم واتجاه الأجسام الموجهة، ولعرض هندسة التغليف عندما لا تكون محاذية لمحاور الصورة.

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

* `Image`\
  صورة المصدر المستخدمة للعرض والمرجع.
* `Contour`\
  الشكل/الـ contour المستخدم لحساب المستطيل المدور الأدنى المساحة.

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

* `Image`\
  صورة المصدر مع توضيح المستطيل المدور المحسوب والـ contour.
* `Center`\
  نقطة المركز للمستطيل المدور المحسوب.
* `Width`\
  قيمة العرض للمستطيل المدور.
* `Height`\
  قيمة الارتفاع للمستطيل المدور.
* `Angle`\
  زاوية دوران المستطيل (الاتجاه).
* `Contour`\
  تمثيل الـ contour للمستطيل المدور (كمخرج شكل).
* `Rectangle Image`\
  معاينة منفصلة تُظهر المنطقة المقصوصة/المصححة للمستطيل.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

لا يحتوي هذا البلوك على ضوابط قابلة للتحرير من قبل المستخدم. يعمل تلقائيًا عند تزويده بكلتا المدخلات.

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

* يحسب مستطيلاً بأدنى مساحة قد يكون مدورًا بالنسبة لمحاور الصورة.
* يوفر قياسات هندسية: المركز، العرض، الارتفاع والزاوية.
* يعرض النتائج مباشرةً على صورة المصدر وكصورة مستطيل منفصلة.
* يخرج المستطيل كـ contour/shape بحيث يمكن توجيهه إلى بلوكات أخرى لمزيد من المعالجة.

## ⚙️ آلية العمل <a href="#running-mechanism" id="running-mechanism"></a>

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

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

1. زود مدخل `Contour` بشكل يمثل الجسم المراد (انظر النصائح حول كيفية الحصول على الـ contours).
2. وصل نفس صورة المرجع (أو نسخة منها) إلى مدخل `Image` إذا أردت عرضًا مشروحًا.
3. اطلع على القيم في مخرجات `Center` و`Width` و`Height` و`Angle` للاستخدام في القياس أو المنطق.
4. استخدم مخرج `Rectangle Image` عندما تحتاج إلى عرض مقصوص أو مُصحح للمنطقة المكتشفة.

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

* للحصول على contours من الصور الخام، اجمع مع `Find Contour` أو `Feature Detector` لاستخراج أطراف الأجسام قبل ربطها بهذا البلوك.
* إذا كانت الـ contours ضوضائية أو تحتوي نقاطًا كثيرة، استخدم `Approximate Contour` لتبسيط الـ contour وتحسين ثبات القياس.
* للأشكال التي يُغلفها أفضل قشرة محدبة، جرّب `Hull Convex` أولاً ثم مرّر الناتج إلى هذا البلوك.
* قارن بين هندسيات التغليف المختلفة بربط هذا البلوك مع `Minimum Circle`، `Minimum Ellipse`، أو `Minimum Rectangle` لاختيار الأنسب لتطبيقك.
* استخدم `Image ROI Select` أو `Image ROI` لقص المنطقة قبل استخراج الـ contour عندما تهتم بمنطقة فرعية فقط.
* صوّر أو صدر النتائج باستخدام `Draw Rectangle` أو `Draw Result On Image` للحصول على تراكبات واضحة في التقارير أو الواجهة.

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

* لم تُنتَج قياسات: تأكد من توصيل `Contour` بصيغة صالحة وأن الـ contour ليس فارغًا.
* اتجاه أو حجم غير متوقع: جرّب تبسيط الـ contour باستخدام `Approximate Contour` أو تحقق أن الـ contour يعبر عن الجسم المقصود (استخدم `Contour to Image` للفحص).
* المستطيل لا يغطي الجسم بشكل صحيح: تحقق من خطوة استخراج الـ contour للثغرات أو القطع المتقطعة؛ فكر في استخدام `Hull Convex` لصنع غلاف قبل القياس.