Image ROI Polygon Multi

تسمح لك هذه الدالة برسم وتحرير وحفظ عدة مناطق اهتمام متعددة الزوايا (polygons) مباشرة على صورة. استخدمها لتحديد أشكال عشوائية، استخراج لقطات مقنّعة (masked crops)، وتصدير إحداثيات المضلعات للمعالجة التالية — كل ذلك بتفاعلات بسيطة بالفأرة ولوحة المفاتيح.

📥 المدخلات

Image Any قدّم الصورة التي تريد تعليقها (annotate). بمجرد توصيل صورة وتشغيل البلوك، تصبح الصورة قماش الرسم للرسم والتعديل على المضلعات.

📤 المخرجات

Highlighted Image تعيد الصورة الأصلية مع المضلعات المطبقة كطبقات توضيحية (المحفوظة والحالية) وعلامات مرئية.

Polygon Images تعيد قائمة بالصور المقتطعة والمقنّعة — صورة لكل مضلع محفوظ — مع الحفاظ على بكسلات المنطقة داخل كل مضلع.

Polygons تعيد قائمة بشكل المضلعات على هيئة قوائم إحداثيات (contours) قابلة للاستخدام في بلوكات دوال أخرى.

🕹️ الضوابط (Controls)

Draw Polygon Canvas منطقة تفاعلية على الصورة حيث ترسم المضلعات بنقرات الفأرة اليسرى.

Press C يمسح المضلع الحالي (أو يزيل آخر مضلع محفوظ إذا لم يكن هناك مضلع حالي).

Press U يتراجع عن النقطة الأخيرة للمضلع الحالي. إذا لم يوجد مضلع حالي، فسيعيد آخر مضلع محفوظ إلى وضع التحرير.

Press S يحفظ المضلع الحالي (يتطلب على الأقل 3 نقاط). تصبح المضلعات المحفوظة جزءًا من قوائم المخرجات.

تفاعلات الفأرة: النقر الأيسر لإضافة نقطة؛ السحب على رأس نقطة لتحريكها؛ التوجيه فوق الرؤوس لإبرازها وتمكين التحرير. يتغير شكل مؤشر الفأرة ليشير إلى وضع الإنشاء أو تحرير الرؤوس.

🎨 الميزات (Features)

• تحرير متعدد المضلعات مستمر: أنشئ عدة مضلعات والتنقل بين المضلع الحالي والمحفوظين.

• طبقات توضيحية مرئية: ألوان مختلفة تشير للمضلعات المحفوظة، المضلع الجاري تحريره، الرؤوس المظللة، والنقاط النشطة.

• قص ROI قابل للتصدير: يعيد صورًا مقتطعة ومقنّعة لكل مضلع محفوظ صالحة للمعالجة الإضافية.

• تصدير الإحداثيات: يعيد إحداثيات رؤوس المضلعات كقوائم contour قياسية للاستخدام اللاحق.

• اختصارات لوحة مفاتيح بسيطة للتحرير السريع (C, U, S) ورسم بديهي بالماوس.

⚙️ كيفية التشغيل (How it runs)

• عند توصيل صورة إلى المدخل وتشغيل البلوك، تظهر الصورة في قماش الرسم التفاعلي.

• ارسم نقاطًا على القماش لتشكيل مضلع. تتحدّث الطبقات التوضيحية في الوقت الفعلي.

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

• يؤدي تحرير رؤوس النقاط وسحبها إلى تحديث المخرجات عند التقييم التالي.

📝 تعليمات الاستخدام (Usage Instructions)

1. صِل مصدر صورة إلى مدخل Image Any (على سبيل المثال: Camera USB، Load Image، أو Stream Reader).

2. انقر على القماش لإضافة رؤوس المضلع. أضف ثلاث نقاط على الأقل لتكوين مضلع.

3. استخدم Press S لحفظ المضلع الحالي. ستُضمّن المضلعات المحفوظة في المخرجات.

4. لتصحيح نقطة، حرّك المؤشر حتى يبرز الرأس ثم اسحبه إلى الموضع الجديد.

5. استخدم Press U للتراجع عن النقطة الأخيرة، أو Press C لمسح المضلع الحالي.

6. شغّل البلوك للحصول على مخرجات Highlighted Image وPolygon Images وPolygons لتمريرها إلى بلوكات أخرى.

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

• اختر مسبقًا مناطق الاهتمام باستخدام Image ROI Select أو Image ROI عندما تحتاج فقط للتركيز على منطقة فرعية قبل رسم المضلعات.

• استخدم Apply Mask بعد هذا البلوك لدمج أقنعة المضلعات مع منطق قناع آخر (مثلًا لإزالة الخلفية أو دمج أقنعة متعددة).

• مرّر Polygon Images إلى بلوكات التحليل أو الكشف مثل Find Object، Object Detection، أو Mask Detection لتشغيل الكشف داخل المناطق المحددة فقط.

• احفظ أمثلة من ROIs المقتطعة باستخدام Image Logger أو Image Write لبناء مجموعة بيانات مرجعية من المضلعات المختارة.

• لعرض تراكبات متعددة محفوظة جنبًا إلى جنب، استخدم Image Concatenate أو Collage Images مع خرج Polygon Images.

• للمعالجة المسبقة قبل الرسم (مثلاً لإنشاء قناع ثنائي تريد تتبعه)، استخدم Blur، Image Threshold، أو HSV Filter في المسار السابق لتبسيط الحدود.

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

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

• لا يمكن حفظ المضلع: تحقق أن المضلع الحالي يحتوي على ثلاث نقاط على الأقل قبل الضغط على Press S.

• مخرجات المضلعات فارغة: تأكد من حفظ المضلعات (باستخدام Press S) وليس إبقائها كحالٍ فقط؛ المضلعات غير المحفوظة غير مدرجة في Polygon Images أو Polygons.

• المقطع المقتطع للمضلع يبدو فارغًا: تأكد أن المضلع داخل حدود الصورة وأن الصورة تحتوي على بيانات بكسل صالحة. عند الحاجة، قم بعمل معالجة مسبقة مثل Normalize Image أو Denoising قبل الرسم.