> 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/image-transformations/analysis/histogram-on-line.md).

# Histogram On Line

This function block analyzes pixel values along a single defined line in a grayscale or binary image. It detects segments where pixel values exceed a threshold and visualizes the line and found segments on an output image.

## 📥 المدخلات

`Input Image (Binary Image)`\
صورة ثنائية أو رمادية اللون تُستخدم لتحليل الخط.

## 📤 المخرجات

`Output Image`\
الصورة المصدر مع تعليمات توضح الخط والمناطق المكتشفة.

`Peak Count`\
عدد المقاطع المكتشفة على طول الخط التي تتجاوز العتبة.

`Peak Start Locations`\
قائمة بإحداثيات نقاط بداية كل مقطع مكتشف.

`Peak End Locations`\
قائمة بإحداثيات نقاط نهاية كل مقطع مكتشف.

`Peak Mean Locations`\
قائمة بإحداثيات المركز (المتوسط) لكل مقطع مكتشف.

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

`Relation`\
قائمة منسدلة لاختيار اتجاه الخط (عمودي أو أفقي).

`Line Location`\
شريط تمرير / إدخال لتحديد موقع الخط بالبكسل (قيمة مفردة). يتم التحقق من القيمة بالنسبة لأبعاد الصورة.

`Pixel Threshold`\
شريط تمرير / إدخال لقيمة عتبة البكسل (0–255) المستخدمة لتحديد المقاطع النشطة.

## 🎨 الميزات

* تغذية بصرية تُظهر خطًا أحمر وعلامات ملونة لبداية المقطع ونهايته وموقع المتوسط.
* يقبل خطوطًا رأسية أو أفقية ويتحقق من صلاحية موقع الخط مقابل أبعاد الصورة.
* يتجاهل المقاطع التي تلامس حواف الصورة (سلوك داخلي قابل للتكوين) لتجنب تأثير الحواف.
* يعيد مخرجات بصرية ومهيكلة للاستخدام في خطوات لاحقة.

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

1. قدّم صورة رمادية أو ثنائية إلى مدخل `Input Image (Binary Image)`.
2. اختر اتجاه الخط باستخدام `Relation`.
3. اضبط `Line Location` (مؤشر البكسل) داخل حدود الصورة.
4. اضبط `Pixel Threshold` بين 0 و255 للتحكم في الحساسية.
5. شغّل البلوك للحصول على صورة معلمة وقوائم بإحداثيات المقاطع المكتشفة.

## 📊 التقييم

عند التنفيذ، يأخذ البلوك عينات من قيم البكسل على طول الخط المختار، يجد المقاطع المتجاورة التي تفي أو تتجاوز العتبة، يعلمها على الصورة المخرجة، ويُرجع عدد المقاطع وقوائم الإحداثيات.

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

* قم بعمل معالجة مسبقة للمدخلات المزعجة باستخدام `Blur` لتقليل الاكتشافات العشوائية و`Image Threshold` لإنشاء صورة ثنائية نظيفة قبل تحليل الخط.
* استخدم `Image ROI Select` أو `Image ROI` لاقتصاص منطقة الاهتمام بحيث تكون إحداثيات الخط أبسط وأكثر معنى.
* ادمجه مع `Draw Line` إذا رغبت في وضع تفاعلي للخط على الصورة المعروضة، ثم انسخ موقع البكسل إلى `Line Location`.
* استخدم `HSV Filter` لعزل قنوات اللون أو الميزات قبل التحويل إلى تدرج الرمادي للحصول على اكتشاف ذروة أكثر موثوقية.
* افحص النتائج بصريًا بربط `Output Image` إلى `Show Image` لفتح عرض أكبر والتحقق من المقاطع المكتشفة.
* إذا كان تدفقك قد يُنتج صورًا فارغة، ففكّر في استخدام `Is None` لحماية المنطق اللاحق من النتائج المفقودة.

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

* إذا لم يتم العثور على أي قمم، جرّب خفض `Pixel Threshold` أو قم بالمعالجة المسبقة باستخدام `Image Threshold` / `Blur`.
* إذا تسببت موضع الخط في أخطاء، تأكد أن `Line Location` ضمن عرض الصورة (للخط العمودي) أو ارتفاع الصورة (للخط الأفقي). سيُبلغ البلوك عن القيم خارج النطاق وسيقوم بقصها.
* إذا ظهرت العديد من المقاطع الصغيرة، زد العتبة أو قم بتنعيم الصورة أولًا باستخدام `Blur`.