> 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/shape-analysis/choose-line.md).

# Choose Line

هذه الدالة تساعدك على اختيار قطعة خط واحدة من داخل `Contour` وتزويدك بمعلومات هندسية عنها. الواجهة تعرض المحيط ونقاطه، تتيح لك اختيار المقطع الذي تريد قياسه، وتخرج شكل الخط، نقاط النهاية، الطول والزاوية — كل ذلك بواجهة سهلة للمستخدمين غير المبرمجين.

## 📥 المدخلات

* `Image Any` الصورة التي سيُرسم عليها المحيط والخط المختار وتُعرض للمعاينة.
* `Contour` المحيط (الشكل) الذي يُختار منه زوج نقاط متتالي لتشكيل الخط.

(هذه هي مآخذ الإدخال للبلوك.)

## 📤 المخرجات

* `Generic Image` الصورة التي تحتوي على المحيط، النقاط، والخط المختار لغاية التأكيد البصري.
* `Length` الطول المقاس لمقطع الخط المختار بوحدة البيكسل.
* `Point 1` إحداثيات نقطة النهاية الأولى للخط المختار.
* `Point 2` إحداثيات نقطة النهاية الثانية للخط المختار.
* `Angle` اتجاه الخط المختار بالدرجات.
* `Line` الخط المختار كمخرج شكل (shape) يمكن توصيله للبلوكات التالية.

(هذه هي مآخذ الإخراج التي يوفرها البلوك.)

## 🕹️ الضوابط

* `Line selection dropdown` اختر أي زوج نقاط متتالي داخل `Contour` لاستخدامه كخط.
* `Line properties label` يعرض معلومات نصية عن الخط المحدد حالياً مثل نقاط النهاية، الطول والزاوية.

(تظهر هذه الضوابط في واجهة البلوك ويمكن التفاعل معها.)

## 🎯 الميزات

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

## ⚙️ كيفية التشغيل

* عند توفير `Contour` صالح، يسرد البلوك مقاطع الخط القابلة للاختيار بناءً على نقاط المحيط.
* يرسم البلوك المحيط ويعلم كل نقطة. اختيار عنصر من `Line selection dropdown` يبرز المقطع الموافق.
* يحسب البلوك المسافة الإقليدية بين النقاط المختارة وزاوية الخط، يحدث `Line properties label`، ويعيد الصورة المرئية والمخرجات الرقمية والشكلية.
* إذا لم يكن هناك محيط صالح، يعيد البلوك الصورة المدخلة دون تغيير ويعيد تعيين النص في بطاقة الخصائص.

## 📝 طريقة الاستخدام

1. وصل صورة معالجة إلى `Image Any` (عادة صورة تحتوي على محيطات مكتشفة).
2. وصل شكل المحيط إلى `Contour` (مثلاً ناتج من بلوك كشف المحيط).
3. افتح `Line selection dropdown` واختر المقطع المطلوب لفحصه.
4. اطلع على مخرجات القياس `Length`, `Point 1`, `Point 2`, و`Angle` أو مرّر `Line` إلى بلوكات لاحقة.

## 💡 نصائح وحيل

* استخدم بلوك `Find Contour` لتزويد `Contour` موثوق به.
* إذا احتجت محيطًا أبسط قبل اختيار الخط، جرّب `Approximate Contour` لتقليل عدد النقاط وتسهل الاختيار.
* لفحص منطقة مقصوصة فقط، ضع قبل هذا البلوك `Image ROI Select` أو `Get ROI` حتى تُقاس النقاط والخط ضمن نفس الإطار الذي يهمك.
* لاستخراج منطقة الخط المختار لمعالجات لاحقة (مثل المطابقة بالشكل أو فحص التوزيع اللوني)، مرّر مخرج `Generic Image` إلى بلوكات مثل `Contour to Image` أو `Image ROI`.
* ادمجه مع `Draw Line`, `Draw Point` أو `Draw Rectangle` إذا رغبت في إضافة تعليقات مرئية إضافية على صورة الإخراج قبل العرض أو الحفظ.
* مرّر المخرجات الرقمية مثل `Length` و`Angle` إلى بلوكات التحليل أو التوثيق (مثلاً `CSV Export` أو `Data to JSON`) لتسجيل نتائج القياس.

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

* إذا لم تظهر خطوط قابلة للاختيار في القائمة، تأكد من أن البلوك السابق زود `Contour` صالحًا (المحيط يجب أن يحتوي على نقاط متعددة).
* إذا بدت المؤشرات المختارة خارج النطاق، جرّب تبسيط المحيط باستخدام `Approximate Contour` أو تحقق أن الصورة والمحيط في نفس مساحة الإحداثيات/القص.
* إذا بدت القياسات غير صحيحة، تحقّق أن الصورة لم تُعدّل حجمها أو تُجَهّز بطريقة تغير الإحداثيات؛ إن حصل ذلك، استخدم رموز ROI أو خطوات تغيير الحجم المتطابقة لضمان اتساق الإحداثيات.