> 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-multi.md).

# Image ROI Select Multi

كتلة تفاعلية لاختيار وتعديل عدة مناطق مستطيلة للاهتمام (ROIs) على صورة. يمكنك رسم، تحريك وتغيير حجم المستطيلات مباشرة على معاينة الصورة للحصول على صور مقصوصة وإحداثيات المستطيلات بالبكسل للاستخدام في المراحل التالية من المعالجة.

## 📥 المدخلات

`Image`\
وصل صورة ملونة أو رمادية لتُستخدم كمصدر لاختيار الـ ROI.

## 📤 المخرجات

`Images`\
صور مقصوصة لكل ROI (قائمة).

`Rectangles`\
مستطيلات بالبكسل لكل ROI (قائمة).

`Selected Image`\
القصّة الخاصة بالـ ROI المحدد حالياً (صورة مفردة أو لا شيء).

`Selected Rectangle`\
مستطيل البكسل الخاص بالـ ROI المحدد (مستطيل مفرد أو لا شيء).

## 🕹️ الضوابط

* Draw: انقر واسحب على مساحة فارغة داخل المعاينة لإنشاء ROI جديد.
* Move: انقر واسحب داخل المستطيل لتحريكه.
* Resize: انقر واسحب حواف أو زوايا المستطيل لتغيير حجمه.
* `Ctrl` امسك أثناء السحب لإجبار إنشاء مستطيل جديد (حتى لو كنت فوق ROI موجود).
* `C` اضغط لمسح كل الـ ROIs.
* `U` اضغط للتراجع عن آخر ROI تم إنشاؤه.
* `Delete` / `Backspace` اضغط لإزالة الـ ROI المحدد.
* `Escape` اضغط لإلغاء الاختيار/السحب.

تُظهر المعاينة تراكبات ومقابض تشير إلى حالات التحويم والاختيار والمعاينة.

## 🎨 الميزات

* تحرير متعدد الـ ROIs: إنشاء العديد من ROIs في جلسة صورة واحدة.
* معاينة مباشرة: تراكب تفاعلي وتحديث المعاينة أثناء التعديل.
* مخرجات دقيقة بالبكسل: تُعيد `Rectangles` و`Selected Rectangle` إحداثيات بالبكسل نسبةً إلى حجم الصورة المصدر.
* واجهة متجاوبة: تضبط المعاينة حجمها لتناسب مساحة الكتلة وتحافظ على التراكبات متناسقة.
* تسلسل الحفظ: يتم حفظ الـ ROIs والاختيار عند حفظ/تحميل السيناريو.

## 📊 كيف يعمل

* عندما تصل صورة إلى مدخل `Image` يخزن البلوك الصورة كمصدر حالي ويحدّث المعاينة.
* يحول البلوك تعريفات الـ ROI الحالية إلى مستطيلات بالبكسل باستخدام حجم الصورة المصدر ويصدر: `Images` (قص لكل ROI)، `Rectangles` (إحداثيات البكسل)، `Selected Image` و`Selected Rectangle`.
* إذا لم تكن صورة متصلة، يعيد البلوك قوائم فارغة وقيم لا شيء (لا قصوص).

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

1. وصل بلوك ينتج صورة إلى مدخل `Image` (كاميرا، محمل، تيار).
2. انقر واسحب على معاينة الصورة لإنشاء ROIs. استخدم الحواف/الزوايا لتعديل الحجم.
3. انقر داخل مستطيل لتحديده؛ القصّة المحددة متاحة عبر `Selected Image`.
4. استخدم اختصارات لوحة المفاتيح (`C`, `U`, `Delete`/`Backspace`, `Escape`) وامسك `Ctrl` لتعديل سلوك الإنشاء.
5. استخدم المخرجات في الكتل التالية لتحليل أو حفظ القصوص.

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

* فحص سريع: وصل مخرج `Selected Image` إلى كتلة Show Image لعرض القصّة المحددة في عارض أكبر.
* معالجة جماعية: مرّر مخرج `Images` إلى Collage Images لإنشاء عرض مجمّع لكل القصوص، أو إلى Image Logger / Image Write لحفظ القصوص تلقائياً.
* تركيز التحليل: استخدم مخرج `Rectangles` كمدخل إلى `Get ROI` عندما تريد تطبيق نفس قائمة المستطيلات على صور أخرى (مثلاً سلسلة زمنية أو لقطات مختلفة).
* الدمج مع الكاشفات: أنشئ ROIs لتحديد مناطق الاهتمام، ثم أرسل الصور المقتصة (`Images`) إلى كتل مثل `Find Object`, `Feature Detector`, `Blob Detector` أو `OCR` لتنفيذ كشف/تعرف موجه لكل قصّة.
* التصوير البصري: ارسم `Rectangles` المرجعة على الصورة المصدر باستخدام `Draw Rectangle` أو `Draw Detections` لعرض النتائج بجانب العلامات الأخرى.
* المعالجة المسبقة: قبل اختيار ROI يدوياً يمكنك تهيئة الصورة المصدر باستخدام `Blur`, `Image Threshold` أو `HSV Filter` لجعل البُنى أسهل للرؤية والاختيار.
* استخدام مع حلقات الأنابيب: مرّر قصوص ROI إلى كتل Analysis أو AI (مثل `Object Detection` أو `Background Removal`) لإنشاء تدفقات معالجة فعالة لكل منطقة.

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

* عدم وجود معاينة أو تعطيل الضوابط: تأكد من توصيل صورة صالحة بمدخل `Image`.
* عدم تصدير ROIs بشكل صحيح: تحقق من أن صورة المصدر لها الأبعاد الصحيحة؛ البلوك يخرج مستطيلات بالبكسل نسبةً إلى حجم الصورة المدخلة.
* سلوك اختيار غير متوقع: امسك `Ctrl` أثناء السحب لإجبار إنشاء ROI جديد بدلاً من تعديل واحد موجود.
* عدد كبير جداً أو مفقود من ROIs في الخطوات اللاحقة: تحقق من أنك تستخدم المخرج الصحيح (`Images` مقابل `Selected Image`) وأن الكتل التالية تقبل مدخلات قائمة عند تغذية عدة قصوص.