> 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/input-output/image-inputs/camera-usb-vidgear.md).

# Camera USB Vidgear

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

## 📥 المدخلات

`Activate Signal`\
تفعيل الكاميرا والبدء بإرجاع الإطارات (مقبس إدخال)

`Release Signal`\
إطلاق الكاميرا وتحرير الموارد (مقبس إدخال)

## 📤 المخرجات

`Image Any`\
إطار الكاميرا الحالي (مقبس إخراج)

## 🕹️ الضوابط

`Scan Connected USB Cameras`\
مسح النظام وإدراج الكاميرات USB المتاحة

`Select USB Camera`\
قائمة منسدلة لاختيار الكاميرا المكتشفة التي تريد استخدامها

`Camera Resolution`\
قائمة منسدلة لاختيار دقة الالتقاط المفضلة

`Current Resolution`\
تسمية تعرض الدقة النشطة التي أعادتها الكاميرا

`Open Advanced Setting`\
يفتح حوار إعدادات البائع/النظام الخاص بالكاميرا عند توفره

`Message Area`\
منطقة رسائل الحالة والأخطاء الظاهرة للمستخدم داخل الواجهة

## 🎨 الميزات

* التقاط مباشر من كاميرا USB مناسب لسيناريوهات الإنتاج والاختبار.
* اكتشاف سهل: امسح واختر من الكاميرات المتصلة دون مغادرة الواجهة.
* التحكم في الدقة: اختر دقات شائعة ويعرض البلوك الدقة الفعلية النشطة.
* سلوك البدء/الإيقاف عبر `Activate Signal` و`Release Signal` لإدارة الموارد.
* تعامل متدرج مع مشاكل البث المؤقتة: يحتفظ البلوك بآخر إطار صالح، يعرض رسائل توضيحية، ويحاول استعادة البث تلقائياً إذا أمكن.
* دعم اختياري لرفع الإطارات في الخلفية للتصدير أو التسجيل غير المتزامن (إذا تم تكوينه في بيئتك).
* تغذية بصرية: تعرض الواجهة الحالة الحالية والرسائل المفيدة داخل واجهة البلوك.

## ⚙️ آلية التشغيل

* انقر على `Scan Connected USB Cameras` لملء قائمة الكاميرات، ثم اختر كاميرا من `Select USB Camera`.
* استخدم `Camera Resolution` لطلب عرض/ارتفاع مفضل؛ تُظهر تسمية `Current Resolution` ما تم ضبطه فعلياً من قِبل الكاميرا.
* عندما يتم تزويد `Activate Signal` يبدأ البلوك بإرجاع الإطارات عبر مخرج `Image Any`. إذا لم يكن الإشارة نشطة، يستمر البلوك في الاحتفاظ بإطار الالتقاط الأخير وإعادته.
* عند تزويد `Release Signal` يتوقف البلوك عن تشغيل الكاميرا ويحرر المورد؛ لا يزال الإطار الأخير المتاح يُعاد حتى يتم إعادة تفعيل الكاميرا.
* إذا واجه البلوك تكراراً في الإطارات الفارغة/التالفة أو خطأ في البث، سيعرض رسالة خطأ ويحاول استرداد أو إعادة تشغيل الكاميرا تلقائياً لتجنب فشل صامت في السيناريوهات الحية.

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

1. انقر على `Scan Connected USB Cameras` لاكتشاف الكاميرات.
2. اختر الكاميرا المطلوبة باستخدام `Select USB Camera`.
3. اختياريًا اختر دقة من `Camera Resolution`.
4. أرسل `Activate Signal` لبدء استقبال الإطارات من مخرج `Image Any`.
5. أرسل `Release Signal` عندما لا تعود بحاجة إلى الكاميرا لتحرير الجهاز.

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

* معاينة الإطارات الحية بربط مخرج `Image Any` إلى `Show Image` للحصول على تغذية مرئية فورية.
* لتسجيل أو حفظ الإطارات، ربط مخرج `Image Any` إلى `Image Logger`, `Image Write` أو `Record Video`.
* إذا كنت بحاجة لمعالجة أسرع مع تقبل جودة أقل، ضع `Image Resize` قبل المعالجة المكثفة لتقليل الحمل الحسابي.
* حسّن متانة الكشف بإدراج معالجة أولية بسيطة مثل `Blur`, `Denoising` أو `Auto Contrast` بين خرج الكاميرا وكتل الذكاء الاصطناعي.
* للتحليل المستهدف استخدم `Image ROI Select` أو `Image ROI Polygon` لاقتطاع المشهد قبل الكشف.
* اجمع مع كتل AI مثل `Object Detection`, `Mask Detection`, `Pose Estimation` أو `Object Detection - Custom` لبناء خطوط فحص أو تحليلات. للاستخدام مع التتبع ضع `Object_Detection_Tracker` بعد كتلة كشف الأجسام.
* لنشر النتائج إلى أنظمة خارجية، مرر المخرجات الرقمية/النصية الناتجة إلى كتل مثل `MQTT Publish` أو `REST API - Post`.
* إذا رأيت إطارات سوداء متكررة، جرّب إعادة مسح قائمة الكاميرات أو قم بالتبديل عبر `Release Signal` لفرض إعادة تشغيل الكاميرا المختارة.

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

* لا توجد كاميرات بعد المسح: تأكد من توصيل الكاميرا، تشغيلها وعدم استخدامها حصرياً من تطبيق آخر. أعد المسح بعد إعادة التوصيل.
* فشل الكاميرا في البدء أو البث: تحقق من الكاميرا المحددة في `Select USB Camera` وجرب دقة مختلفة في `Camera Resolution`. استخدم `Release Signal` ثم أعد التفعيل.
* إطارات سوداء متقطعة أو تالفة: يحتفظ البلوك بآخر إطار صالح لتفادي الثغرات؛ إذا استمرت المشكلة، أعد المسح وأعد اختيار الكاميرا أو جرّب منفذ USB مختلف.
* عناصر تحكم الكاميرا المتقدمة غير متاحة: بعض حوارات بائعي الكاميرات خاصة بالمنصة. استخدم خيارات الدقة داخل البلوك أو أدوات النظام الخاصة بالكاميرا عند الحاجة لإعدادات متقدمة.

## 🔗 أمثلة على التوليف

* المراقبة الحية: `Camera USB Vidgear` -> `Show Image`.
* التسجيل والتحليل اللاحق: `Camera USB Vidgear` -> `Record Video` و/أو `Image Logger`؛ ثم أدخل الإطارات المسجلة إلى `Find Object` أو `Histogram On Line`.
* خط أنابيب الفحص: `Camera USB Vidgear` -> `Image ROI Select` -> `Object Detection` -> `Object_Detection_Tracker` -> `Image Write`.

استخدم هذه التركيبات لبناء تدفقات رؤية حاسوبية زمن-حقيقي قوية دون الحاجة للتعامل مع تفاصيل التنفيذ.