Measure Object Distance

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

📥 المدخلات

• Main Image الصورة التي سيتم تحديد الجسمين وقياس المسافة بداخلهما.

• 1st Object Image صورة قالب (مثال) للجسم الأول الذي تريد العثور عليه.

• 2nd Object Image صورة قالب (مثال) للجسم الثاني الذي تريد العثور عليه.

📤 المخرجات

• Image Any النتيجة المرئية التي تعرض الأجسام المقاسة والعلامات.

• Distance المسافة الإقليدية المحسوبة بين مركزي الجسمين المكتشفين (مع مضروب عامل القياس المختار).

• X Distance المسافة الأفقية بين مركزي الجسمين.

• Y Distance المسافة العمودية بين مركزي الجسمين.

🕹️ الضوابط

• Measure Factor أدخل قيمة رقمية لتحويل المسافة بالبكسل إلى وحدات العالم الحقيقي (مثلاً مم لكل بكسل).

• Measured distance تسمية عرض تظهر المسافة المحسوبة للرجوع السريع.

• Image Preview منطقة عرض مرئية تعرض صورة الإدخال وعلامات القياس.

⚙️ آلية التشغيل

عند تشغيل البلوك، يبحث عن تطابقات في Main Image مع مثالَي الجسمين المقدمين، يحدد مراكز كل جسم مُكتشف، ثم يحسب مسافات X و Y والمسافة الإقليدية بين هذين المركزين. تُضرب المسافة المحسوبة في قيمة Measure Factor لإظهار النتيجة بالوحدة المطلوبة. يتم تحديث معاينة الصورة لعرض المواضع المكتشفة والقياس.

✨ الميزات

• ملاحظات مرئية بعلامات وصورة معاينة مشروحة للتحقق السريع.

• مخرجات رقمية لتقارير قياس دقيقة ومعالجة لاحقة.

• تحكم بسيط عبر مدخل واحد Measure Factor لتحويل البكسلات إلى وحدات حقيقية.

• منطقة معاينة قابلة لتغيير الحجم لتفحص النتائج بوضوح أكبر.

📝 كيفية الاستخدام

1. ضع صورة المشهد في Main Image.

2. ضع صور أمثلة للجسمين في 1st Object Image و 2nd Object Image (يجب أن تمثل ما تتوقع العثور عليه).

3. اضبط Measure Factor لتحويل المسافات من بكسل إلى وحدات حقيقية (اتركها 1 إذا أردت وحدات بكسل).

4. شغّل التدفق وافحص معاينة Image Any وكذلك المخرجات Distance، X Distance، Y Distance.

💡 نصائح وحيل

• إذا كان من الصعب مطابقة القوالب في المشهد الكامل، قم أولاً بقص المنطقة باستخدام Image ROI Select لتقليل منطقة البحث وتسريع المطابقة.

• استخدم Image Resizer أو Image Resize لمعايرة أحجام الصور إذا كانت صور القوالب مأخوذة بدقة مختلفة عن الصورة الرئيسية.

• حسّن موثوقية المطابقة بمعالجة سابقة مثل Adjust Colors، Contrast Optimization، أو Blur لتقليل الضوضاء وإبراز الميّزات.

• للتحقق بصرياً، أربط مخرج Image Any إلى Show Image لعرض المعاينة بحجم أكبر.

• عند القياس عبر أزواج متعددة أو التتبع عبر الزمن، احفظ الإطارات باستخدام Image Logger أو صدر القياسات عبر CSV Export لتحليل لاحق.

• إذا كان لديك مستطيلات مكتشفة مسبقاً من كاشف أشياء، يمكنك دمج هذا البلوك مع كتل الكشف (مثل Find Object) لاستخدامها لتحديد مواضع القوالب بشكل أقوى قبل القياس.

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

• لم يتم العثور على أجسام: تأكد أن صور الأمثلة تشبه ظهور الأجسام في Main Image (نفس المقياس، الاتجاه والإضاءة). فكّر في استخدام Image Resize أو Adjust Colors.

• مقياس المسافة غير صحيح: تحقق من قيمة Measure Factor. للحصول على مقياس حقيقي، قِس مرجعاً معروفاً بالبكسل واستخرج العامل الصحيح.

• تطابقات متعددة أو خاطئة: قم بقص منطقة البحث باستخدام Image ROI Select أو زد التباين عبر Contrast Optimization لتقليل المطابقات الخاطئة.

• المعاينة لا تتحدّث: تأكد من وجود صورة صالحة في Main Image وأعد فتح المعاينة (لاستعراض أكبر استخدم Show Image).