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

# Contour to Image

تقوم هذه الدالة باستخراج منطقة مستطيلة من الصورة حول `Contour` معيّن. قدّم صورة المصدر و`Contour` (الشكل) وسيُعيد البلوك صورة مقطوعة مستطيلة تحتوي على الـ`Contour`. يفيد هذا البلوك عندما تريد عزل وفحص جسم واحد تم اكتشافه داخل صورة أكبر.

## 📥 المدخلات

* `Image` — صورة المصدر التي تحتوي على الجسم المراد قصّه. يمكن أن تكون ملونة أو رمادية.
* `Contour` — الشكل/المحيط الذي يصف حدود الجسم. قدّم `Contour` الناتج من بلوك إيجاد المحيطات أو معالجة الأشكال.

## 📤 المخرجات

* `Image` — الصورة المقطوعة المستطيلة التي تحتوي المنطقة المحيطة بالـ`Contour` المقدّم.

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

* `No Controls` — لا يحتوي هذا البلوك على عناصر تحكم تفاعلية. يعمل تلقائيًا عند استقبال المدخلات ويُنتج الصورة المقتطعة.

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

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

## ✨ الميزات

* يستخرج صورة مستطيلة مركزة حول الـ`Contour` لتبسيط التحليل اللاحق.
* يعمل مع المحيطات الناتجة عن بلوكات كشف الأشكال وتحليلها المختلفة.
* يُعيد صورة جاهزة للاستخدام للعرض، أو التعرف، أو الحفظ.

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

1. أنشئ المحيطات من صورتك (مثلاً عبر العتبة Threshold وبلوك `Find Contour`).
2. اربط صورة المصدر بـ`Image` والمدخل `Contour` بالـ`Contour` المطلوب.
3. سيخرج البلوك الصورة المقطوعة عند `Image`. استخدمها كمدخل لبلوكات أخرى (مثل التعرف، OCR، أو الحفظ).

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

* لتوليد المحيطات قبل هذا البلوك، استخدم البلوك `Find Contour`.
* إذا احتجت إلى شكل مبسّط قبل القص، جرّب `Approximate Contour` لتقليل عدد الزوايا.
* للأجسام المائلة، قارن النتائج مع `Minimum Rotated Rectangle` أو `Minimum Rectangle` لاختيار أفضل شكل يحيط بالـ`Contour` في سير العمل.
* عاين الناتج بسرعة باستخدام البلوك `Show Image`.
* بعد القص، يمكنك تطبيق `Image Resize` لتطبيع الأحجام، أو `Auto Contrast` / `Denoising` لتحضير المقطوعات للمهام التالية.
* لحفظ المقتطعات تلقائيًا، ربط مخرج هذا البلوك بـ`Image Logger` أو `Image Write`.

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

* إذا كان المخرج غير متوقع أو فارغًا، تأكد من أن مدخل `Contour` يحتوي على `Contour` صالح (ليس `None`). استخدم `Find Contour` أو `Approximate Contour` لإنتاج محيطات صحيحة.
* إذا بدا القص مقطوعًا، تحقق من أن إحداثيات الـ`Contour` تقع ضمن حدود صورة المصدر. قد تحتاج إلى تعديل المعالجة الأولية أو اختيار الـ`Contour`.
* إذا ظهر الجسم مائلًا أو مشوهاً وتحتاج منظورًا مختلفًا، جرّب `Minimum Rotated Rectangle` أو اتبع سير عمل واعٍ بالمنظور (قص ثم `Auto Alignment` / `Perspective Transform`) قبل التحليل اللاحق.