> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/detections-shapes/draw/draw-point.md).

# Draw Point

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

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

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

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

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

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

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

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

## 🎨 المزايا <a href="#features" id="features"></a>

* مؤشرات مرئية: يرسم دوائر مملوءة مع حواف ذات لونين لجعل النقاط واضحة على خلفيات مختلفة.
* حجم مؤشر متكيف: يتغير حجم المؤشر تلقائيًا بناءً على دقة الصورة ليبقى مرئيًا على الصور الصغيرة والكبيرة.
* يقبل نقطة واحدة أو متعددة: يعمل مع إحداثية واحدة أو قائمة من الإحداثيات للوسم الجماعي.
* غير مدمر: ينتج نسخة من الصورة مع الطبقات المرئية، ويحافظ على الصورة الأصلية في المسار الأعلى.

## 📊 طريقة العمل <a href="#evaluation" id="evaluation"></a>

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

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. وصل بلوك ينتج صورة إلى مدخل `Image Any`.
2. زوّد مدخل `Points` بإحداثية واحدة أو قائمة إحداثيات.
3. استخدم المخرج `Image Any` للمعاينة (مثلاً بواسطة بلوك `Show Image`) أو لتمرير الصورة الموسومة إلى بلوكات التصدير أو المعالجة التالية.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* للحصول على إحداثيات نقر المستخدم، اربط البلوك مع `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` في المجرى السابق إذا احتجت تعديل حجم المؤشرات أو كثافتها للعرض أو التصدير.

## 🛠️ استكشاف الأعطال <a href="#troubleshooting" id="troubleshooting"></a>

* إذا لم تظهر المؤشرات، تحقق من أن مدخل `Points` يحتوي إحداثيات صالحة داخل حدود الصورة (0 ≤ x < width, 0 ≤ y < height).
* إذا ظهر مؤشر واحد فقط بينما تتوقع عدة مؤشرات، تأكد أن `Points` هو قائمة من صفوف الإحداثيات وليس صفًا واحدًا فقط.
* إذا كانت المؤشرات صغيرة جدًا أو كبيرة جدًا بالنسبة للصورة، قُم بتغيير حجم الصورة باستخدام `Image Resize` أو اقص الصورة بواسطة `Image ROI` قبل الرسم.