Line Geometry

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

📥 المدخلات

• Input Image صورة اختيارية تُستخدم لعرض الطبقات التوضيحية (إذا رغبت في رسم خطوط، نقاط أو محـاـيطات).

• Line 1 مطلوب لمعظم العمليات. يقبل خطًا موصوفًا كـ [(x1, y1), (x2, y2)] أو شكل مدخل متوافق.

• Line 2 مطلوب لعمليات الزاوية / التقاطع / وبعض عمليات المسافة. يقبل خطًا ثانيًا بنفس الصيغة.

• Anchor Point نقطة اختيارية (x, y) تُستخدم في عمليات الإسقاط ونقطة-إلى-خط أو عند تزويد محيط لاشتقاق تقاطعات الشكل.

📤 المخرجات

• Output Image صورة مشروحة (إذا تم توصيل Input Image وتم تفعيل Show Visualization).

• Result النتيجة الرقمية للعملية المختارة (مثل الزاوية بالدرجات أو المسافة بالبكسل).

• Point Output نتيجة كنقطة عند إرجاع إحداثية (مثل نقطة التقاطع، الإسقاط، النقطة الوسطى).

• Extra Output بيانات إضافية خاصة بالعملية (مثل نقاط نهاية المقاطع، قائمة نقاط التقاطع، أو معلومات تصحيح الأخطاء).

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

• Operation Type اختر نوع العملية الهندسية المراد تنفيذها (مثل Angle Between Lines, Intersection Point, Segment Extraction, Projection).

• Offset (px) شريط لتطبيق إزاحة بالبكسل في عمليات المقاطع / الإسقاطات.

• Interpolation Factor شريط (0–100%) يُستخدم في العمليات المعتمدة على الاستيفاء (استخراج المقاطع، الإسقاط على طول الخط).

• Show Visualization خانة اختيار لتشغيل رسم Output Image المشروح عندما تتوفر Input Image.

🎯 الميزات الرئيسية

• كتلة واحدة متعددة الأغراض تغطي العديد من مهام الهندسة الشائعة.

• سلوك حساس للسياق: فقط المخرجات المتعلقة بالعملية المحددة ستكون ذات بيانات مفيدة.

• طبقات توضيحية اختيارية: ارسم خطوطًا، نقاطًا وسطى، تقاطعات، إسقاطات ومقاطع مباشرة على الصورة الموفرة.

• تلميحات تفاعلية على عناصر التحكم تساعدك على اختيار المدخلات والبارامترات الصحيحة لكل عملية.

⚙️ آلية التنفيذ

عند التشغيل، تقرأ الكتلة المقابس المتصلة وOperation Type المحدد. تؤدي الحساب الهندسي المطلوب باستخدام Line 1 وLine 2 الاختياري وAnchor Point الاختياري. إذا تم توصيل Input Image وتم تفعيل Show Visualization، تُرجع الكتلة صورة مشروحة في Output Image. تظهر النتائج الرقمية والنقاطية على المخرجات المقابلة بناءً على العملية.

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

1. اختر العملية المطلوبة في Operation Type.

2. وصل المقابس المطلوبة: على الأقل قم بتوصيل Line 1. وصل Line 2 أو Anchor Point حسب ما تتطلبه العملية المختارة.

3. اختياريًا قدّم Input Image وفعل Show Visualization للحصول على طبقة مشروحة على الصورة.

4. اضبط Offset (px) أو Interpolation Factor عند استخدام عمليات استخراج المقاطع أو الإسقاط.

5. شغّل السيناريو؛ افحص Result وPoint Output و/أو Extra Output، واطّلع على التراكب المرئي في Output Image أو عبر كتلة عرض مثل Show Image.

💡 نصائح وحيل (الدمج مع كتل أخرى)

• للحصول على خطوط تلقائيًا من محيطات أو حواف، ادمج مع Find Contour أو Line Detector لاستخراج بيانات الأشكال/الخطوط وإدخالها إلى Line Geometry.

• قص منطقة وعمل هندسة مركزة باستخدام Image ROI, Image ROI Select أو Image ROI Polygon قبل إرسال الصورة إلى هذه الكتلة — هذا يقلل الضوضاء ويحسّن النتائج.

• صوّر المخرجات في واجهة المستخدم باستخدام Show Image حتى تتمكن من فحص الصور المشروحة والتحقق تفاعليًا من النقاط والتقاطعات.

• إذا احتجت لإضافة نتائج نصية على الصورة المشروحة للتقارير، أضف Draw Result On Image بعد المخرج المرئي.

• لقياس المسافات بين ميزات مكتشفة، استخدم Find Contour أو Feature Detector لتحديد النقاط، ثم استخدم Line Geometry لحساب النقاط الوسطى أو المسافات أو الإسقاطات. مرّر مخرجات النقاط الرقمية إلى Measure Position Distance للحصول على تحليلات إضافية للمسافات.

• لعزل الاكتشافات ذات الصلة فقط قبل الحسابات الهندسية، استعمل Image ROI Select أو Check Area (Polygon) لتصفية المواقع والأشكال.

• عند دمج اكتشافات مع سير عمل تتبع، استخدم Object Detection أو Object Detection - Custom upstream لتوفير الإحداثيات، ثم استخدم Line Geometry للتحليلات مثل فحوصات التقاطع أو حساب زاوية الاقتراب.

(تلميح: استخدم مخرجات الكتلة مثل Point Output أو Extra Output كمدخلات لكتل معالجة أخرى مثل Measure Position Distance, Draw Point أو كتل التسجيل/التصدير.)

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

• إذا كانت Output Image فارغة: تأكد من توصيل Input Image وتفعيل Show Visualization.

• إذا أرجعت العملية لا قيمة في Result أو Point Output: تحقق من توصيل المقابس المطلوبة لتلك العملية (مثال: Line 2 مطلوب لعمليات الزاوية/التقاطع).

• إذا بدت الإحداثيات خاطئة: تحقق من صيغة الإحداثيات وأن الخطوط موصوفة كـ [(x1, y1), (x2, y2)]. استخدم كتل المعاينة مثل Show Image أو Draw Point لفحص النقاط الوسيطة.

• لنتائج الإسقاط والاستيفاء التي تبدو غير دقيقة، ضبط قيم Offset (px) وInterpolation Factor بما يتوافق مع المقياس والوحدات المتوقعة.

إذا احتجت إلى فحوص بصرية خطوة بخطوة، اجمع الكتلة مع Show Image وDraw Point للتحقق من الهندسة الوسيطة قبل استخدام النتائج في المراحل اللاحقة.