> 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/get-roi.md).

# Get ROI

يقوم هذا البلوك باستخراج منطقة مستطيلة من الصورة المدخلة. استخدمه عندما تريد قص منطقة محددة لإجراء تحليل إضافي أو للعرض.

## 📥 الإدخالات <a href="#inputs" id="inputs"></a>

* `Image Any` — الصورة المصدر التي سيتم استخراج المنطقة منها.
* `Rectangle` — إحداثيات المستطيل التي تحدد المنطقة المراد استخراجها (عادة نقطتا الزاوية).

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

* `Image Any` — المنطقة المقتَصّة كصورة.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

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

## 🎨 الميزات <a href="#features" id="features"></a>

* قص بسيط مستطيل يتم تسليمه كمخرَج صورة للبلوكات التالية.
* يقبل مستطيل الإدخال كمجموعتي إحداثيات زاويتين (مثلاً الأعلى-يسار والأسفل-يمين).
* يتعامل تلقائياً مع قيم المستطيل الموجودة خارج حدود الصورة لتجنب أخطاء وقت التشغيل.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. صِل الصورة المصدر إلى مدخل `Image Any`.
2. قدّم `Rectangle` الذي يصف المنطقة المطلوب استخراجها. يمكن توليد هذا المستطيل بواسطة بلاكات اختيار ROI التفاعلية أو بلاكات أخرى التي تُخرِج إحداثيات المستطيل.
3. استخدم مخرج `Image Any` لإرسال المنطقة المقتَصّة إلى البلوكات التالية.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التنفيذ، يعيد هذا البلوك الصورة الموجودة داخل المستطيل المقدم. إذا امتد المستطيل خارج حدود الصورة، فسيتم اقتطاع المنطقة إلى نطاق الصورة الصالح.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* للاختيار التفاعلي، اِدمج مع `Image ROI Select` لرسم مستطيل على المصدر وتوصيل مخرجاته إلى مدخل `Rectangle`.
* لاستخراج مناطق متعددة دفعة واحدة، استخدم `Image ROI Select Multi` أو `Image ROI Polygon Multi` لتوليد عدة مستطيلات أو مضلعات، ثم أدخل كل مستطيل في نسخ منفصلة من هذا البلوك أو نفّذ تكراراً باستخدام بلاكات التحكم بالتدفق.
* معاينة الناتج المقتَصّ بتوصيل المخرج إلى `Show Image`.
* استخدم `Image Resize` أو `Image Padding` بعد هذا البلوك إذا كان البلوك التالي يتطلب حجم صورة محدد.
* في سير عمل معتمد على الكائنات، قص المنطقة أولاً (بواسطة هذا البلوك) ثم نفّذ `Find Object`، `Template Match` أو `Histogram On Line` على المنطقة المقتَصّة لتحسين السرعة وتقليل المطابقات الخاطئة.
* للحصول على قص متمركز، اقترن مع `Image ROI Center` لتوليد مستطيل حول نقطة مركزية مختارة.
* استخدم `Draw Rectangle` على مسار العرض لتصوير ROI المحدد على الصورة الأصلية للتحقق.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

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