> 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/blob-detector.md).

# Blob Detector

تكتشف هذه الوحدة الوظيفية الميزات الشبيهة بالبُقَع (أجسام مستديرة فاتحة/داكنة) داخل الصورة. استخدم المساطر لضبط حساسية الكشف ومرشحات الشكل حتى يعثر البلوك على البقع التي تهمك فقط.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Image Any` الصورة التي سيتم تحليلها بحثًا عن البقع.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

`Image Any` الصورة الناتجة مع تعليم البقع المكتشفة.\
`Number of Blobs` عدد البقع المكتشفة.\
`Blobs Positions` قائمة بمراكز البقع (x, y).\
`Blobs Sizes` أحجام (القطر) البقع المكتشفة.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Threshold Range` القيم الدنيا والقصوى لشدة البكسل المستخدمة لاكتشاف مرشحي البقع.\
`Area Range` الحد الأدنى والحد الأقصى لمساحة البقعة كنسبة من مقياس الصورة.\
`Circularity Range` نطاق الدائرية المسموح به لتفضيل الأشكال المستديرة.\
`Convexity Range` نطاق التحدب المسموح به لاستبعاد الأشكال شديدة الانخماص.\
`Inertia Range` نطاق نسبة العطالة المسموح به لتصفية البقع الممدودة مقابل المستديرة.

## 🎯 الميزات <a href="#features" id="features"></a>

* تغذية بصرية: تُرسم البقع المكتشفة على صورة الإخراج حتى تتمكن من فحص النتائج فورًا.
* تصفية حسب الشكل: ضيّق الاكتشافات باستخدام مساطر `Area`, `Circularity`, `Convexity` و`Inertia` لتقليل الإيجابيات الكاذبة.
* ضبط مباشر: تؤثر تعديلات المساطر على التقييم التالي بحيث يمكنك التكرار بسرعة.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. قدّم صورة إلى `Image Any`.
2. ابدأ بنطاق `Threshold Range` واسع واضبطه حتى تظهر معظم مرشحات البقع على صورة الإخراج.
3. استخدم `Area Range` لإزالة الاكتشافات الصغيرة جدًا أو الكبيرة جدًا بالنسبة لحجم الهدف.
4. اضبط `Circularity Range`, `Convexity Range` و`Inertia Range` لاستبعاد الأشكال غير الشبيهة بالبقع.
5. افحص النتائج في صورة الإخراج واقرأ المخرجات الرقمية لأغراض الأتمتة أو التسجيل.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

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

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

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

(تلميح: استخدم البلوكات ذات الصلة التالية لتحسين المتانة والسرعة: `Blur`, `Image Threshold`, `Image ROI Select`, `Image Resizer`, `Denoising`, `Show Image`, `Image Logger`, `Draw Detections`)

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* عدم اكتشاف أي بقع: وسّع `Threshold Range` وزد `Area Range`؛ فتّش على تباين الصورة المدخلة.
* الكثير من البقع الصغيرة الكاذبة: زد الحد الأدنى في `Area Range` أو طبق `Blur` / `Image Threshold` لإزالة الضوضاء.
* اكتشاف أشكال ممدودة أو غير منتظمة: ضيّق `Circularity Range` و/أو عدّل `Inertia Range` لتفضيل البقع المستديرة.
* اكتشافات غير متسقة عبر الإطارات: تأكد من ثبات الإضاءة، أو طبق معالجة مسبقة (`Auto Contrast` / `Denoising`) لتثبيت صور الإدخال.