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

# Image ROI

تتيح هذه الدالة اقتصاص منطقة اهتمام من صورة مدخلة باستخدام منزلقات نطاق أفقية. قم بضبط منزلقات `Width` و`Height` لتحديد اقتصاص مستطيل؛ يُخرج البلوك الصورة المقصوصة وإحداثيات المستطيل لمزيد من المعالجة.

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

`Image Any` قدّم الصورة المصدر التي تريد اقتصاصها.

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

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

`Rectangle` إحداثيات منطقة الاهتمام على شكل مستطيل.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Width` منزلق نطاق أفقي لتعيين حدود الاقتصاص يسار/يمين (min و max).

`Height` منزلق نطاق عمودي لتعيين حدود الاقتصاص أعلى/أسفل (min و max).

`Input Image Size (H, W)` تسمية معلوماتية تُظهر أبعاد الصورة المدخلة وتحدّث نطاقات المنزلقات تلقائياً.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

عند استلام البلوك لصورة مدخلة، يقرأ أبعاد الصورة ويحدّث نطاقات منزلقات `Width` و`Height` لتطابق حجم الصورة. توفر المنزلقات قيم صحيحة min/max تُحدد مستطيل الاقتصاص. عند التقييم، يرجع البلوك الصورة المقصوصة ومستطيل يمثل الـ ROI.

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

* نطاقات منزلق ديناميكية تتكيف تلقائياً مع حجم الصورة المتصلة.
* يعيد كلاً من الصورة المقصوصة وإحداثيات المستطيل للاستخدام لاحقاً.
* يحفظ تخطيط قنوات الصورة (ملون أو التدرج الرمادي) في النتيجة المقصوصة.
* يتذكر ويستعيد حجم الصورة المدخلة عند حفظ/تحميل السيناريوهات (دعم التسلسل serialization).

## 📝 إرشادات الاستخدام <a href="#usage" id="usage"></a>

1. وصل بلوك ينتج صورة إلى مدخل `Image Any`.
2. راقب الوسم `Input Image Size (H, W)` لتأكيد الأبعاد.
3. اضبط حدّي `Width` min/max لتعيين حدود الاقتصاص الأفقية.
4. اضبط حدّي `Height` min/max لتعيين حدود الاقتصاص العمودية.
5. استخدم المخرجات حسب الحاجة: مرّر الصورة المقصوصة إلى بلوكات التحليل أو استخدم إحداثيات المستطيل للتصور.

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

* لمعاينة الـ ROI أثناء ضبط المنزلقات بصرياً، أرسل مخرج `Image Any` إلى بلوك `Show Image`.
* إذا كانت الصورة المدخلة كبيرة جداً، ضع بلوك `Image Resizer` قبل هذا البلوك لتسريع ضبط المنزلقات التفاعلي.
* استخدم `Image ROI Select` أو `Image ROI Select Multi` إذا فضّلت اختيار مناطق الاقتصاص بالماوس بدلًا من المنزلقات، ثم مرّر المستطيل الناتج إلى هذا البلوك أو استخدم مخرجاته لاحقاً.
* للتركيز على الكشف داخل المنطقة المقصوصة، مرّر الصورة المقصوصة إلى بلوكات الكاشف مثل `Find Object`, `Object Detection`, أو `Blob Detector` لتقليل المطابقات الخاطئة وتسريع المعالجة.
* لحفظ أمثلة عن الـ ROI أو تسجيلها، وصل مخرج الصورة المقصوصة إلى `Image Logger` أو `Image Write`.
* لوضع علامة على الـ ROI على الصورة الأصلية للتصور، استخدم مخرج المستطيل مع `Draw Rectangle` ثم عرض النتيجة عبر `Show Image`.
* اجمع مع `Histogram On Line` أو `Histogram On Curve` لتحليل الملف التعريفي المحدود بالمنطقة المقصوصة.
* استخدم إحداثيات المستطيل مع بلوكات واعية بالـ ROI مثل `Get ROI` أو `Check Area` لبناء منطق لاحق يعتمد على مواقع الكائنات داخل المنطقة المختارة.

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

* إذا لم تغطِ المنزلقات كامل امتداد الصورة، تأكد من توصيل صورة وأنها مرئية في الوسم `Input Image Size (H, W)` — يتم تحديث المنزلقات فقط بعد استلام الصورة.
* إذا كانت النتيجة المقصوصة فارغة أو سوداء، تأكد أن قيم min/max للمنزلقات تحدد مساحة غير صفرية وتقع داخل حدود الصورة.
* إذا كانت البلوكات اللاحقة تتوقع تنسيق قنوات محدد (تدرج رمادي مقابل RGB)، استخدم تحويل الألوان أو بلوك `Image Resizer` / معالجة مسبقة قبل أو بعد الاقتصاص لمطابقة تنسيق المدخلات المتوقعة.