Image ROI Polygon

هذه الدالة (function block) تتيح لك رسم مضلع مباشرةً على الصورة لتحديد منطقة اهتمام مخصصة (ROI). استخدمها لاختيار أشكال غير منتظمة، تعديل رؤوس المضلع تفاعليًا، وإخراج كل من الصورة المقتطعة داخل المضلع وإحداثيات المضلع للمعالجة اللاحقة.

📥 المدخلات (Inputs)

• Image Any الصورة المعروضة والمستخدمة للتعليل. قم بتوصيل أي بلوك يولد صورة هنا حتى تتمكن من رسم المضلع على معاينة حية.

📤 المخرجات (Outputs)

• Image Any الصورة المقتطعة التي تتوافق مع منطقة المضلع. إذا لم يتم تعريف مضلع فقد يكون هذا المخرج فارغًا.

• Polygon إحداثيات المضلع المعادة كقائمة contour/shape مناسبة للاستخدام في بلوكات أخرى.

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

• Left Click إضافة رأس (vertex) في المكان الذي يتم النقر عليه.

• Drag انقر واسحب رأسًا موجودًا لإعادة وضعه.

• U التراجع عن آخر رأس تمت إضافته (Undo).

• C مسح كل الرؤوس والبدء من جديد.

• Overlay Preview تُعرض علامات مرئية والتعبئة أثناء التعديل حتى ترى المضلع والرؤوس ومنطقة التحديد في الوقت الفعلي.

⚙️ آلية التشغيل (Running mechanism)

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

• ارسم المضلع بالنقر لإضافة الرؤوس. يتحدّث الـ overlay فورًا.

• استخدم السحب واختصارات لوحة المفاتيح لتعديل الشكل بدقة.

• عندما يوجد مضلع، ينتج البلوك صورة مقتطعة (المستطيل المحيط الضيق للمضلع) وقائمة إحداثيات المضلع عند كل تقييم.

✨ الميزات (Features)

• رسم مضلع تفاعلي مع إمكانية تعديل الرؤوس.

• اختصارات التراجع/المسح لتصحيحات سريعة.

• تراكب مرئي مع إبراز الرؤوس أثناء التحويم أو السحب.

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

• يدعم ROI غير مستطيلة ومتعددة النقاط للأشكال غير المنتظمة.

📝 نصائح الاستخدام (Usage tips)

• ارسم على الأقل ثلاث نقاط لتشكيل مضلع مملوء؛ نقاط أقل لن تُنتِج لقطة ROI صالحة.

• بعد الرسم، شغّل البلوكات اللاحقة لمعالجة الصورة المقتطعة أو إحداثيات المضلع.

• استخدم السحب لضبط مواقع الرؤوس بدقة لقياسات دقيقة.

💡 نصائح وحيل (Tips and Tricks)

• عاين صورًا أكبر بتوصيل المخرج إلى Show Image لتتمكن من الرسم بدقة على عارض منفصل.

• إذا احتجت إلى عدة ROIs في صورة واحدة، استخدم Image ROI Polygon Multi لتخزين عدة اختيارات مضلع ثم مرّر كلٍ منها إلى بلوكات المعالجة.

• ادمج مع Get ROI أو Image ROI Select إذا فضلت الاقتصاص المستطيلي أولًا ثم دقّق بالمضلع للأشكال المعقدة.

• استخدم Apply Mask بعد هذا البلوك لقناع الصورة الأصلية بالمضلع ومرّر تلك الصورة المقنعة إلى بلوكات التحليل.

• مرّر الصورة المقتطعة للمضلع إلى بلوكات الكشف أو التحليل مثل Find Object, Object Detection, Mask Detection, Histogram On Line أو Color Density Percentage لتركّز المعالجة على المنطقة المحددة.

• إذا كانت الصورة كبيرة جدًا للرسم بشكل مريح، أضف Image Resizer أو Image Resize قبل هذا البلوك؛ تذكّر أن تغيير الحجم يغيّر إحداثيات البكسل المستخدمة من قبل البلوكات الحساسة للهندسة.

• احفظ الـ ROIs المحددة باستخدام Image Logger, Image Write أو Multi Image Write لجمع مجموعات بيانات أو للمراجعة لاحقًا.

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

• لا تظهر أي صورة: تأكد من توصيل بلوك يولد صورة إلى Image Any وشغّل مرة واحدة لملء المعاينة.

• لم يتم إنتاج ROI: تأكد من وجود ثلاث رؤوس على الأقل؛ نقاط أقل لا تكوّن مضلعًا مملوءًا.

• يظهر المضلع في مكان خاطئ بعد تغيير حجم الصور في المسار السابق: ارسم على الدقة النهائية أو أدرج Image Resizer بشكل ثابت في الخط لمعالجة اتساق الإحداثيات.

• تحتاج إحداثيات دقيقة لبلوكات أخرى: استخدم مخرج Polygon (قائمة الإحداثيات) وتحقق عبر معاينة بواسطة Show Image أو أعد التشغيل بعد التعديلات.