> 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/detectors/match-shapes.md).

# Match Shapes

تم تصميم هذا البلوك لمقارنة شكلين (contours) وإرجاع قيمة تشابه رقمية بين 0 و1. مفيد عندما تريد مقياسًا رقميًا واحدًا لمدى تشابه اثنين من الحدود — القيم الأقرب إلى 1 تعني تشابهاً أكبر.

## 📥 المدخلات

`Contour` — الحد الأول للمقارنة (المرجع).

`Contour` — الحد الثاني للمقارنة (الاستعلام).

## 📤 المخرجات

`Resemblence` — رقم بين 0 و1 يعبر عن مدى تشابه الحدين (كلما زادت القيمة = كلما كان التشابه أكبر).

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

`Resemblence` — تسمية فقط للقراءة تعرض قيمة التشابه الحالية كتعليق مرئي سريع في واجهة المستخدم.

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

عند تشغيل البلوك، يستقبل حدين (contours) كمداخل، يحولهما إلى تمثيلات قابلة للمقارنة، ويحسب قيمة تشابه وحيدة. تُعرض النتيجة كمخرج رقمي وتُحدّث أيضًا تسمية `Resemblence` داخل البلوك لتمكين معاينة فورية للنتائج.

## 🎯 الميزات

* مقياس رقمي سريع للتشابه بين حدين.
* تغذية راجعة في الواجهة عبر تسمية `Resemblence` الحية.
* يعمل مع الحدود المنتجة من بلوكات تحليل الأشكال والكشف الأخرى (مثل `Find Contour`، إلخ).

## 📝 كيفية الاستخدام

1. وفّر الحدين في المداخل. يمكن الحصول على الحدود من بلوكات الكشف أو معالجة الحدود.
2. شغّل التدفق؛ سيعيد البلوك قيمة `Resemblence` ويحدّث التسمية للمراجعة الفورية.
3. استخدم الناتج الرقمي لاتخاذ قرارات، أو للتسجيل، أو للمعالجة اللاحقة.

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

* إذا كان لديك صورة فقط، استخرج الحدود أولاً باستخدام بلوك `Find Contour` ثم مرّر الحدود الناتجة إلى هذا البلوك.
* لتبسيط الحدود المعقدة وتقليل الضجيج أو عدد النقاط، جرّب `Approximate Contour` قبل المطابقة؛ الحواف الأبسط تعطي قيم تشابه أكثر استقرارًا.
* إذا كنت تريد قَصّ الحد إلى صورة للمقارنة البصرية، استخدم `Contour to Image` واستعرض النتيجة بـ `Show Image`.
* لمقارنة مرشحين متعددين مقابل مرجع واحد، اجمع هذا البلوك مع `Most Similar Shape` لاختيار الأنسب تلقائيًا.
* عند مطابقة أشكال في مناطق محددة، قم بقص الصورة أولاً باستخدام `Image ROI Select` حتى تأتي الحدود من المنطقة المتوقعة.
* إذا كانت الحدود تأتي من صور بمقاييس مختلفة، قم بتطبيع الأحجام باستخدام `Image Resize` أو حول الحدود إلى صور مقطوعة بنفس الأبعاد عبر `Contour to Image`.

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

* إذا بدا أن قيمة التشابه منخفضة بشكل غير متوقع: تأكد من أن الحدين بنفس المقياس والتوجيه. جرّب تبسيط الحدود بواسطة `Approximate Contour` أو تطبيع أحجام الصور.
* إذا كان الناتج غير مستقر عبر الإطارات، تحقق من خطوة استخراج الحدود (مثل `Find Contour`) للبحث عن اكتشافات ضوضائية وفكّر في المعالجة المسبقة باستخدام `Blur` أو `Image Threshold`.
* لا يوجد مخرج أو مدخل حد غير صالح: تأكد أن البلوك المنتج للحدود يُرجع فعلاً بيانات حدود (استخدم `Debug Input` أو عاين الصور الوسيطة بـ `Show Image`).