Get ROI

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

📥 الإدخالات

• Image Any — الصورة المصدر التي سيتم استخراج المنطقة منها.

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

📤 المخرجات

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

🕹️ الضوابط

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

🎨 الميزات

• قص بسيط مستطيل يتم تسليمه كمخرَج صورة للبلوكات التالية.

• يقبل مستطيل الإدخال كمجموعتي إحداثيات زاويتين (مثلاً الأعلى-يسار والأسفل-يمين).

• يتعامل تلقائياً مع قيم المستطيل الموجودة خارج حدود الصورة لتجنب أخطاء وقت التشغيل.

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

1. صِل الصورة المصدر إلى مدخل Image Any.

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

3. استخدم مخرج Image Any لإرسال المنطقة المقتَصّة إلى البلوكات التالية.

📊 التقييم

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

💡 نصائح وحيل

• للاختيار التفاعلي، اِدمج مع 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 المحدد على الصورة الأصلية للتحقق.

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

• إذا كان المخرج فارغاً أو مقتَطعاً بشكل غير متوقع، تحقّق من أن Rectangle يحتوي على نقطتي زاوية صحيحتين داخل حدود الصورة.

• إذا بدا القص منزاحاً أو مقلوباً، تأكد أن ترتيب نقاط المستطيل هو الأعلى-يسار ثم الأسفل-يمين (أو الترتيب المقبول من مصدر ROI لديك).

• إذا كنت بحاجة إلى ROI بحجم ثابت من صور ذات دقة متغيرة، أضف Image Resize قبل أو بعد هذا البلوك لتطبيع الأبعاد.