> 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/detectors/measure-object-distance.md).

# 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`).