> 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-line.md).

# Draw Line

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

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

`Image Any` الصورة التي سيتم الرسم عليها. وصل أي بلوك يولد صورة إلى هنا.

`Calculate All Points` عند تعيينه إلى true، يرجع البلوك كل إحداثيات البكسل على طول كل مقطع مرسوم بدلاً من نقاط النهاية فقط.

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

`Image Any` الصورة المشروحة التي تعرض الخطوط المرسومة أو النقاط المحسوبة.

`Line Coordinates` قائمة بأشكال الخط تمثل كل مقطع مرسوم.

`Angles` قيم الدوران أو الزوايا لكل مقطع خط.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

`Image Area` انقر بزر الفأرة الأيسر على منطقة الصورة لإضافة نقاط وبناء الخطوط.

`Press U` التراجع عن آخر نقطة أو مقطع تمت إضافته.

`Press C` مسح كل النقاط والخطوط المرسومة.

(تلميح) منطقة الصورة تعرض تغذية بصرية فورية أثناء الإضافة أو التراجع أو المسح.

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

* الرسم التفاعلي مباشرة على الصورة مع عرض مرئي فوري.
* اختصارات لوحة المفاتيح للتحرير السريع: التراجع (`Press U`) والمسح (`Press C`).
* خيار لإرجاع قوائم إحداثيات كثيفة على طول كل خط عند تفعيل `Calculate All Points`.
* تقدير الزاوية لكل مقطع، مفيد لمهام التوجيه أو المحاذاة.

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

1. وصل بلوك يولد صورة إلى مدخل `Image Any` (مثل كاميرا أو محمل صور).
2. انقر على منطقة الصورة لوضع النقاط. النقرات المتتالية تشكل مقاطع الخط.
3. للحصول على كل إحداثيات البكسل على المقاطع، قم بتوفير قيمة TRUE لمدخل `Calculate All Points`.
4. استخدم `Press U` للتراجع عن آخر نقطة أو `Press C` لمسح كل العلامات.
5. اطلع على المخرجات للحصول على الصورة المشروحة، قائمة `Line Coordinates`، و`Angles`.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التشغيل، يقوم هذا البلوك بتحديث معاينة الصورة التفاعلية بالخطوط المرسومة ويحسب المخرجات بناءً على النقاط الحالية. إذا كان `Calculate All Points` مفعلاً، يقوم البلوك بتوسيع كل مقطع إلى إحداثيات البكسل المكونة له قبل إرجاع النتائج.

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

* للمدخل الحي من الكاميرا، قم بتوصيل `Camera USB` أو `Stream Reader` إلى مدخل `Image Any` للرسم مباشرة على الإطارات الحية.
* لعرض النتائج بصريًا في نافذة أكبر، قم بإقران هذا البلوك مع `Show Image` بعد المخرجات.
* إذا أردت تقييد الرسم على منطقة محددة، قم بقص الصورة أولًا باستخدام `Image ROI Select` أو `Image ROI` ثم أدخل الصورة المقصوصة إلى هذا البلوك.
* لتحليل دقيق على طول خط مرسوم، فعّل `Calculate All Points` واستخدم `Measure Position Distance` أو `Histogram On Line` على الإحداثيات أو الصورة الناتجة.
* قلل الضوضاء قبل الرسم بمعالجة المدخل باستخدام `Blur` أو `Denoising` عندما تكون الحواف مزعجة.
* عند العمل مع صور كبيرة جدًا، استخدم `Image Resizer` لتقليل الدقة لأداء تفاعلي أسرع، ثم قم بإعادة مطابقة الإحداثيات لاحقًا إذا لزم الأمر.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* لا يوجد استجابة عند الرسم: تأكد من وجود صورة صالحة متصلة بمدخل `Image Any` وأن السيناريو يعمل.
* النقاط غير مصفوفة كما هو متوقع: قُم بتكبير أو تغيير حجم مصدر الصورة بشكل متسق بين المعاينة والاستخدام اللاحق، أو قم بقصها باستخدام `Image ROI Select` قبل الرسم.
* إرجاع الكثير من الإحداثيات: عطل `Calculate All Points` إذا كنت تحتاج فقط إلى نقاط نهاية المقاطع، أو قلل حجم الصورة لتقليل كثافة النقاط.