> 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/pose-estimation.md).

# Pose Estimation

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

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

`Image Any`\
الصورة المراد تحليلها (إطار الكاميرا، صورة محمّلة، أو صورة تمت معالجتها سابقًا).

`Show Skeleton`\
مدخل منطقي (Boolean) لتشغيل أو إيقاف رسم الهيكل العظمي على الصورة الناتجة.

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

`Image Any`\
الصورة مع رسم الهيكل العظمي (إذا كان `Show Skeleton` مفعلًا) وعلامات مرئية لنقاط المفاتيح المكتشفة.

`Selected Body Part Positions`\
نتيجة على شكل خريطة (dictionary-like) تربط أسماء أجزاء الجسم المحددة بإحداثياتها المكتشفة (x, y). تُرجع فقط مجموعات أجزاء الجسم التي تختارها.

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

`Class Names`\
قائمة قابلة للاختيار لمجموعات أجزاء الجسم المبسطة (مثال: head, chest, elbow, hand, hip, knee, foot). علّم المجموعات التي تريد أن يبلغ عنها البلوك.

`Confidence`\
شريط تمرير لضبط ثقة الكشف. قيمة أعلى تقلل الإيجابيات الكاذبة لكن قد تفوّت اكتشافات ضعيفة؛ خفضها يجعل الكشف أكثر تساهلًا.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* عند تزويد البلوك بصورة في `Image Any`، يقوم بتحليل الصورة ومحاولة تحديد نقاط مفاتيح الإنسان.
* إذا كان `Show Skeleton` يساوي `TRUE`، يضيف البلوك خطوط الهيكل والعلامات على الصورة الناتجة.
* يرجع البلوك الصورة المشروحة وخريطة تربط أسماء أجزاء الجسم المحددة بمواقعها المكتشفة. إذا لم يُكتشف جزء بثقة كافية، فسيُستبعد من الخريطة.

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

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

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

1. قدّم مصدر صورة إلى `Image Any` (مثل: `Camera USB`, `Load Image`, أو `Stream Reader`).
2. اختر مجموعات أجزاء الجسم التي تريدها باستخدام `Class Names`.
3. اضبط حساسية الكشف باستخدام شريط `Confidence`.
4. اختياريًا أرسل قيمة منطقية إلى `Show Skeleton` لتفعيل/تعطيل رسم الهيكل.
5. اعرض الصورة الناتجة باستخدام `Show Image` أو سجّل/صدّر الإحداثيات للاستخدام اللاحق.

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

* استخدم `Camera USB` كمصدر صورة مباشر عند العمل بمشاهد الزمن الحقيقي.
* غيّر حجم الصور الواردة باستخدام `Image Resize` إذا بدا الأشخاص صغيرين — بكسلات أكبر للشخص تحسّن دقة نقاط المفاتيح.
* نفّذ كاشفًا سريعًا أولًا (مثل `Object Detection`) ثم قص الأشخاص باستخدام `Image ROI` لإرسال صور كل شخص على حدة إلى هذا البلوك — هذا يحسن الموثوقية ويقلل تكلفة المعالجة.
* لمعاينة النتائج في مساحة العمل، وصل هذا البلوك إلى `Show Image`.
* احفظ الإطارات المحتوية على اكتشافات باستخدام `Image Logger` أو صدّر الإحداثيات بـ `Data to JSON` أو `CSV Export` للتحليل لاحقًا.
* ادمج مع `Draw Result On Image` أو `Draw Detections` لإضافة نصوص حالة أو صناديق محيطة مع الهياكل العظمية.

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

* لا توجد نقاط مكتشفة: جرّب خفض قيمة `Confidence` أو زياد حجم الصورة المدخلة باستخدام `Image Resize`.
* نقاط خاطئة أو مرتجفة: زد قيمة `Confidence` وحسّن الإضاءة أو الحدة (استخدم `Blur` بحذر لإزالة الضجيج فقط).
* الأشخاص جزئيًا خارج الإطار: استخدم سير عمل اكتشاف/قص سابق (مثل `Object Detection` → `Image ROI`) ليكون الموضوع في منتصف الصورة قبل تشغيل هذا البلوك.
* بطء الأداء: قلل دقة الإدخال باستخدام `Image Resize` أو عالج مناطق الأشخاص المقتصة بدلًا من الصورة كاملة.

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