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 أو خطوات تغيير الحجم المتطابقة لضمان اتساق الإحداثيات.