> 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/ai-blocks/face-detection.md).

# Face Detection

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

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

`Image Any` الصورة التي سيتم تحليلها للعثور على الوجوه (ملونة أو رمادية). يمكن أن تكون إطارات من كاميرا أو صور محملة.

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

`Image Any` صورة مع تعليمات مرئية (مربعات حول الوجوه المكتشفة).

`Face Area Coordinates` قائمة بإحداثيات المستطيلات لكل وجه مكتشف.

`Face Count` عدد الوجوه المكتشفة في صورة الإدخال.

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

`Confidence Threshold %` منزلق لضبط الحد الأدنى لثقة الكشف. زِد القيمة لتقليل الإيجابيات الكاذبة، وخفّضها لتكون أكثر تساهلاً.

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

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

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

1. وصّل كتلة إنتاج الصور (كاميرا أو محمّل ملفات) إلى مدخل `Image Any`.
2. اضبط منزلق `Confidence Threshold %` على الحساسية المرغوبة.
3. استخدم المخرجات حسب الحاجة:
   * عرض الصورة الموسومة عبر كتلة عرض مثل `Show Image`.
   * قراءة `Face Area Coordinates` للمعالجة داخل المنطقة أو للتتبع.
   * استخدام `Face Count` للتنبيهات أو التسجيل أو تحليلات بسيطة.

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

عند تشغيل الكتلة، تقوم بمسح الصورة الواردة بحثًا عن وجوه تتجاوز مستوى الثقة المحدد وتنتج الصورة الموسومة، وقائمة مستطيلات الوجوه، والعدد المكتشف.

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

* للمعاينة البصرية، وصل مخرج هذه الكتلة إلى `Show Image` لفتح عارض الصور وفحص الاكتشافات.
* إذا كنت تراقب منطقة واحدة فقط (مثل مدخل)، اقتطع الصورة أولًا باستخدام `Image ROI Select` لتقليل الإيجابيات الكاذبة وتسريع المعالجة.
* لتقليل استهلاك المعالج أو زيادة السرعة، ضع `Image Resize` قبل هذه الكتلة لتخفيض حجم الإطارات.
* استخدم `Draw Detections` لدمج مستطيلات الكشف مع تراكبات أو نصوص حالة واضحة على الشاشة.
* احفظ أمثلة للكشف الناجح أو الفاشل باستخدام `Image Logger` للمراجعة والتعديل لاحقًا.
* قم بتمهيد الإدخالات المضطربة باستخدام `Blur` أو كتلة التحويل المناسبة مثل `Image Threshold` لتحسين ثبات الكشف في الصور منخفضة الجودة.

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

* لا توجد وجوه مكتشفة: خفّض `Confidence Threshold %` وتأكد أن الصورة تحتوي على وجوه واضحة (مباشرة أو بزاوية بسيطة). جرّب زيادة التباين أو استخدام `Image Resize` إلى حجم مناسب.
* الكثير من الإيجابيات الكاذبة: ارفع `Confidence Threshold %` واقطع المشهد باستخدام `Image ROI Select` لاستبعاد المناطق غير المهمة.
* مشاكل في الأداء: قلل من دقة الإدخال عبر `Image Resize` أو شغّل الكشف فقط على إطارات محددة باستخدام إشارة تحكم أو استراتيجية تجميع.