Image ROI Select

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

📥 المدخلات

Image Any الصورة المراد قصها. قم بتوصيل صورة تدرج رمادي أو ملونة لتحديد المنطقة التي يمكن اختيارها.

📤 المخرجات

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

Rectangle المستطيل بالبيكسل الذي يصف المنطقة المحددة (إحداثيات الزاوية العلوية اليسرى والسفلية اليمنى).

🕹️ الضوابط

Image Preview المعاينة التفاعلية حيث يمكنك إنشاء وتعديل ROI بالمؤشر.

Drag ارسم مستطيلاً بالسحب على المعاينة، أو اسحب داخل المستطيل لتحريكه.

Edge / Corner Drag غيّر حجم المستطيل بسحب أحد الحواف أو الزوايا.

Ctrl اضغط مع السحب لإنشاء مستطيل جديد حتى لو كان هناك مستطيل موجود بالفعل.

🎯 الميزات

• إنشاء وتحريك وإعادة تحجيم المستطيل تفاعلياً مباشرة على معاينة الصورة.

• تراكب مرئي يعرض المستطيل الحالي ويُبرزه أثناء التفاعل.

• يقبل اختياراً مفرداً أو متكررًا؛ يتم استخدام آخر ROI مُختار للإخراج.

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

• يتم حفظ المستطيل المحدد بحيث يمكن استعادته عند إعادة تحميل المشروع.

⚙️ آلية العمل

• قم بتوصيل صورة إلى مدخل Image Any وشغّل السيناريو مرة واحدة لتحميل الصورة في المعاينة.

• استخدم المعاينة لـ Drag ورسم مستطيل. اسحب داخل المستطيل لتحريكه، أو اسحب الحواف/الزوايا لتغيير حجمه.

• يحسب البلوك إحداثيات البكسل للمستطيل المحدد ويخرج:

  • الصورة المقصوصة المستخرجة بتلك الإحداثيات عبر Image Any

  • إحداثيات المستطيل عبر Rectangle

• يتحدّث التراكب في المعاينة مباشرة أثناء إنشاء أو تعديل الـ ROI.

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

1. قم بتوصيل بلوك مُنتج للصورة إلى مدخل Image Any وشغّل مرة واحدة لملء المعاينة.

2. ارسم الـ ROI بالنقر والسحب على المعاينة.

3. حرّك أو غيّر حجم الـ ROI حسب الحاجة.

4. اضغط Ctrl أثناء السحب لإنشاء مستطيل جديد.

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

💡 نصائح وحيل

• ادمجه مع Show Image لفتح النتيجة المقصوصة في عارض أكبر للفحص.

• إذا كنت تحتاج إلى عدة ROIs قابلة للتعديل، استخدم Image ROI Select Multi بدلاً من هذا البلوك.

• استخدم Image Resize بعد هذا البلوك لتطبيع أحجام القص قبل تشغيل الكشف أو التحليل.

• مرّر ناتج القص إلى Find Object عندما تريد تشغيل المطابقة داخل المنطقة المختارة فقط — هذا يقلل التطابقات الخاطئة ويُسرّع المعالجة.

• احفظ القصاصات المهمة باستخدام Image Logger أو Image Write لتوثيق أمثلة للمراجعة أو كبيانات تدريب.

• لإظهار نتائج الاستدلال أو الإحداثيات على الصورة الأصلية، استخدم Draw Rectangle لاحقًا مع مخرج Rectangle.

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

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

• إذا ظهر التحديد خارج الصورة، تحقق من أبعاد الصورة المدخلة وأعد رسم الـ ROI داخل منطقة المعاينة.

• للمعالجة النهائية، تأكد من أن دقة الصورة المقصوصة مناسبة للبلوكات التالية (استخدم Image Resize إذا لزم الأمر).