Draw Point

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

📥 المدخلات

Image Any الصورة المصدر التي سيُرسم عليها النقاط (RGB/BGR أو تدرج رمادي).

Points إحداثية واحدة أو قائمة من الإحداثيات للرسم. الإحداثيات بصيغة (x, y) أو (col, row) ويمكن أن تكون صفًا واحدًا أو قائمة من الصفوف.

📤 المخرجات

Image Any الصورة الناتجة مع النقاط المرسومة فوقها.

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

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

🎨 المزايا

• مؤشرات مرئية: يرسم دوائر مملوءة مع حواف ذات لونين لجعل النقاط واضحة على خلفيات مختلفة.

• حجم مؤشر متكيف: يتغير حجم المؤشر تلقائيًا بناءً على دقة الصورة ليبقى مرئيًا على الصور الصغيرة والكبيرة.

• يقبل نقطة واحدة أو متعددة: يعمل مع إحداثية واحدة أو قائمة من الإحداثيات للوسم الجماعي.

• غير مدمر: ينتج نسخة من الصورة مع الطبقات المرئية، ويحافظ على الصورة الأصلية في المسار الأعلى.

📊 طريقة العمل

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

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

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

2. زوّد مدخل Points بإحداثية واحدة أو قائمة إحداثيات.

3. استخدم المخرج Image Any للمعاينة (مثلاً بواسطة بلوك Show Image) أو لتمرير الصورة الموسومة إلى بلوكات التصدير أو المعالجة التالية.

💡 نصائح وحيل

• للحصول على إحداثيات نقر المستخدم، اربط البلوك مع Get Pixel Mouse وارسم المواقع التي نُقِرت عليها.

• لعرض مراكز الكائنات المكتشفة، استخدم الإحداثيات الناتجة من Object Detection, Object Detection - Custom أو Object_Detection_Tracker ومررها إلى Points.

• لنقاط قائمة على محيط الشكل، استخرج النقاط باستخدام Find Contour أو Approximate Contour ثم ارسمها بهذا البلوك.

• قُم أولًا بقص منطقة الاهتمام باستخدام Image ROI Select أو Image ROI حتى ترسم النقاط ضمن منطقة محددة فقط.

• اجمع مع Draw Detections إذا أردت وجود مربعات إحاطة ونقاط معًا على نفس الصورة.

• لحفظ الإطارات الموسومة، اربط المخرج بـ Image Logger أو Image Write.

• استخدم Slice Image أو Image Resize في المجرى السابق إذا احتجت تعديل حجم المؤشرات أو كثافتها للعرض أو التصدير.

🛠️ استكشاف الأعطال

• إذا لم تظهر المؤشرات، تحقق من أن مدخل Points يحتوي إحداثيات صالحة داخل حدود الصورة (0 ≤ x < width, 0 ≤ y < height).

• إذا ظهر مؤشر واحد فقط بينما تتوقع عدة مؤشرات، تأكد أن Points هو قائمة من صفوف الإحداثيات وليس صفًا واحدًا فقط.

• إذا كانت المؤشرات صغيرة جدًا أو كبيرة جدًا بالنسبة للصورة، قُم بتغيير حجم الصورة باستخدام Image Resize أو اقص الصورة بواسطة Image ROI قبل الرسم.