> 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/approximate-contour.md).

# Approximate Contour

هذه الوظيفة تُبسط المحيط المُعطى بإنشاء مضلع محيط بعدد أقل من الحواف. تعرض كل من المحيط الأصلي والتقريب المبسّط، وتوفّر معلومات هندسية مثل المركز، المحيط وعدد الزوايا.

## 📥 المدخلات

* `Image Any` الصورة المستخدمة للعرض (يُرسم عليها المحيط الأصلي والمحيط المُقَرب).
* `Contour` المحيط المُدخل الذي سيتم تقريبه (بيانات الشكل).

## 📤 المخرجات

* `Image Any` صورة تُظهر المحيط الأصلي والمضلع المُقَرَّب مع علامات الزوايا.
* `Contour` المحيط المُقَرَّب كمخرج شكل.
* `Center` مركز الكتلة (centroid) للمحيط المُقَرَّب (x, y).
* `Perimeter` طول المحيط للمحيط المُقَرَّب.
* `Number of corners` عدد رؤوس المضلع المُقَرَّب.

## 🕹️ الضوابط

* `Epsilon` شريط منزلق لضبط سماحية التقريب. القيم الأعلى تُنتج مضلعات أبسط بعدد أقل من الزوايا؛ القيم الأقل تحافظ على تفاصيل أكثر.

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

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

## 🎯 الميزات

* مقارنة بصرية: يعرض المحيط الأصلي بلون والمضلع المُقَرَّب بلون آخر على الصورة الناتجة، مع تمييز نقاط الزوايا لفحص سريع.
* مخرجات رقمية: يوفّر موقع المركز، المحيط وعدد الزوايا للاستخدام في منطق لاحق أو تسجيل البيانات.
* تقريب قابل للتعديل: الشريط المنزلق يتيح طريقة بديهية للتوازن بين التبسيط والدقة.

## 📝 تعليمات الاستخدام

1. زوّد مخرج محيط (مثلاً من بلوك `Find Contour`) إلى مدخل `Contour`.
2. زوّد الصورة التي تريد أن تُعلَّم إلى مدخل `Image Any`.
3. عدّل قيمة `Epsilon` حتى يتطابق الشكل المُقَرَّب مع مستوى التفاصيل المطلوب.
4. استخدم المخرجات للعرض، القياس أو المعالجة اللاحقة.

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

* للحصول على محيطات مناسبة للتقريب، استخدم أولًا بلوك `Find Contour` لاكتشاف المحيطات التي تُغذّي هذا البلوك.
* عالج الصورة المصدَرية مسبقًا باستخدام `Blur`, `Image Threshold` أو `Morphological Transformations` لتقليل الضوضاء والحصول على محيطات أنظف.
* استخدم `Image ROI` أو `Image ROI Select` لقص منطقة الاهتمام قبل اكتشاف المحيط وتقريبه لتسريع المعالجة وتجنب الأشكال غير المهمة.
* بعد التقريب، قد ترغب في:
  * تحويل المحيط المُقَرَّب إلى مقصوصة صورة باستخدام `Contour to Image` للفحص المُركَّز.
  * ملاءمة أشكال محيطة بسيطة باستخدام `Minimum Rectangle`, `Minimum Circle` أو `Minimum Ellipse` للقياسات أو محاذاة العناصر.
  * ملء الشكل المُقَرَّب باستخدام `Fill Contour` عندما تحتاج إلى قناع ثنائي للمنطقة.
* استخدم `Draw Rectangle`, `Draw Point` أو بلوكات الرسم الأخرى لإضافة تعليقات مرئية إضافية أو الجمع مع نتائج الكشف.
* لتحويل الإحداثيات (لتعديلات ROI أو المحاذاة)، استخدم `Translate Shape`.

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

* إذا كان المضلع المُقَرَّب خشنًا جدًا أو مفصّلًا أكثر من اللازم، غيّر قيمة `Epsilon` تدريجيًا حتى تحصل على عدد الزوايا المرغوب.
* إذا كانت مخرجات `Contour` فارغة أو غير صحيحة، تأكد من أن مصدر المحيط (مثل `Find Contour`) ينتج أشكالًا صحيحة وأن خطوات المعالجة المسبقة تُنتج فصلًا واضحًا بين المقدمة والخلفية.
* إذا كانت العلامات البصرية في غير مكانها بعد القص أو تحويل الإحداثيات، تحقق من أن البلوكات اللاحقة (ROI أو التحويل أو الرسم) تستخدم أنظمة إحداثيات متسقة.