Image ROI

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

📥 المدخلات

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

📤 المخرجات

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

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

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

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

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

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

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

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

🎯 الميزات

• نطاقات منزلق ديناميكية تتكيف تلقائياً مع حجم الصورة المتصلة.

• يعيد كلاً من الصورة المقصوصة وإحداثيات المستطيل للاستخدام لاحقاً.

• يحفظ تخطيط قنوات الصورة (ملون أو التدرج الرمادي) في النتيجة المقصوصة.

• يتذكر ويستعيد حجم الصورة المدخلة عند حفظ/تحميل السيناريوهات (دعم التسلسل serialization).

📝 إرشادات الاستخدام

1. وصل بلوك ينتج صورة إلى مدخل Image Any.

2. راقب الوسم Input Image Size (H, W) لتأكيد الأبعاد.

3. اضبط حدّي Width min/max لتعيين حدود الاقتصاص الأفقية.

4. اضبط حدّي Height min/max لتعيين حدود الاقتصاص العمودية.

5. استخدم المخرجات حسب الحاجة: مرّر الصورة المقصوصة إلى بلوكات التحليل أو استخدم إحداثيات المستطيل للتصور.

💡 نصائح وحيل

• لمعاينة الـ 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 لبناء منطق لاحق يعتمد على مواقع الكائنات داخل المنطقة المختارة.

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

• إذا لم تغطِ المنزلقات كامل امتداد الصورة، تأكد من توصيل صورة وأنها مرئية في الوسم Input Image Size (H, W) — يتم تحديث المنزلقات فقط بعد استلام الصورة.

• إذا كانت النتيجة المقصوصة فارغة أو سوداء، تأكد أن قيم min/max للمنزلقات تحدد مساحة غير صفرية وتقع داخل حدود الصورة.

• إذا كانت البلوكات اللاحقة تتوقع تنسيق قنوات محدد (تدرج رمادي مقابل RGB)، استخدم تحويل الألوان أو بلوك Image Resizer / معالجة مسبقة قبل أو بعد الاقتصاص لمطابقة تنسيق المدخلات المتوقعة.