> 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/roi-processing/image-roi-select.md).

# Image ROI Select

هذه الدالة تتيح لك تحديد مربع واحد من منطقة الاهتمام (ROI) بشكل تفاعلي عن طريق السحب على معاينة الصورة. وهي مثالية لقص منطقة من الصورة للمعالجة أو الفحص اللاحق.

## 📥 المدخلات

`Image Any` الصورة المراد قصها. قم بتوصيل صورة تدرج رمادي أو ملونة لتحديد المنطقة التي يمكن اختيارها.

## 📤 المخرجات

`Image Any` الصورة المقصوصة المطابقة للمستطيل المحدد.

`Rectangle` المستطيل بالبيكسل الذي يصف المنطقة المحددة (إحداثيات الزاوية العلوية اليسرى والسفلية اليمنى).

## 🕹️ الضوابط

`Image Preview` المعاينة التفاعلية حيث يمكنك إنشاء وتعديل ROI بالمؤشر.

`Drag` ارسم مستطيلاً بالسحب على المعاينة، أو اسحب داخل المستطيل لتحريكه.

`Edge / Corner Drag` غيّر حجم المستطيل بسحب أحد الحواف أو الزوايا.

`Ctrl` اضغط مع السحب لإنشاء مستطيل جديد حتى لو كان هناك مستطيل موجود بالفعل.

## 🎯 الميزات

* إنشاء وتحريك وإعادة تحجيم المستطيل تفاعلياً مباشرة على معاينة الصورة.
* تراكب مرئي يعرض المستطيل الحالي ويُبرزه أثناء التفاعل.
* يقبل اختياراً مفرداً أو متكررًا؛ يتم استخدام آخر ROI مُختار للإخراج.
* يتم إرجاع النتيجة المقصوصة فورًا كصورة مع إحداثيات المستطيل.
* يتم حفظ المستطيل المحدد بحيث يمكن استعادته عند إعادة تحميل المشروع.

## ⚙️ آلية العمل

* قم بتوصيل صورة إلى مدخل `Image Any` وشغّل السيناريو مرة واحدة لتحميل الصورة في المعاينة.
* استخدم المعاينة لـ `Drag` ورسم مستطيل. اسحب داخل المستطيل لتحريكه، أو اسحب الحواف/الزوايا لتغيير حجمه.
* يحسب البلوك إحداثيات البكسل للمستطيل المحدد ويخرج:
  * الصورة المقصوصة المستخرجة بتلك الإحداثيات عبر `Image Any`
  * إحداثيات المستطيل عبر `Rectangle`
* يتحدّث التراكب في المعاينة مباشرة أثناء إنشاء أو تعديل الـ ROI.

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

1. قم بتوصيل بلوك مُنتج للصورة إلى مدخل `Image Any` وشغّل مرة واحدة لملء المعاينة.
2. ارسم الـ ROI بالنقر والسحب على المعاينة.
3. حرّك أو غيّر حجم الـ ROI حسب الحاجة.
4. اضغط `Ctrl` أثناء السحب لإنشاء مستطيل جديد.
5. استخدم المخرجات لإغذية الصورة المقصوصة أو إحداثيات المستطيل إلى البلوكات التالية.

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

* ادمجه مع `Show Image` لفتح النتيجة المقصوصة في عارض أكبر للفحص.
* إذا كنت تحتاج إلى عدة ROIs قابلة للتعديل، استخدم `Image ROI Select Multi` بدلاً من هذا البلوك.
* استخدم `Image Resize` بعد هذا البلوك لتطبيع أحجام القص قبل تشغيل الكشف أو التحليل.
* مرّر ناتج القص إلى `Find Object` عندما تريد تشغيل المطابقة داخل المنطقة المختارة فقط — هذا يقلل التطابقات الخاطئة ويُسرّع المعالجة.
* احفظ القصاصات المهمة باستخدام `Image Logger` أو `Image Write` لتوثيق أمثلة للمراجعة أو كبيانات تدريب.
* لإظهار نتائج الاستدلال أو الإحداثيات على الصورة الأصلية، استخدم `Draw Rectangle` لاحقًا مع مخرج `Rectangle`.

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

* إذا كانت المعاينة فارغة، تأكد من توصيل البلوك المنتج وأنك شغّلت الخط لتعبئة بيانات الصورة مرة واحدة.
* إذا ظهر التحديد خارج الصورة، تحقق من أبعاد الصورة المدخلة وأعد رسم الـ ROI داخل منطقة المعاينة.
* للمعالجة النهائية، تأكد من أن دقة الصورة المقصوصة مناسبة للبلوكات التالية (استخدم `Image Resize` إذا لزم الأمر).