> 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.md).

# Camera USB

توصِل هذه الوظيفة الكاميرات المتصلة عبر USB بالكمبيوتر وتوفّر لقطات حية لمعالجتها أو عرضها. استخدمها لاختيار الكاميرا، تغيير الدقة، والتحكم بوقت تشغيل الكاميرا أو تحريرها من الاستخدام.

## 📥 المدخلات (sockets)

* `Activate Signal` — مدخل منطقي (Boolean) لتفعيل استدعاء الإطارات. عند عدم التفعيل، يحتفظ البلوك بآخر إطار مُلتقط ويُعيده.
* `Release Signal` — مدخل منطقي لإيقاف الكاميرا وتحرير موردها.

## 📤 المخرجات (sockets)

* `Camera Frame` — إطار الصورة الحي القادم من الكاميرا USB المحددة.

## 🕹️ الضوابط

* `Scan Connected USB Cameras` — زر لاكتشاف وعرض الكاميرات USB المتصلة بالنظام.
* `Select USB Camera` — قائمة منسدلة لاختيار الكاميرا المراد استخدامها.
* `Camera Resolution` — قائمة منسدلة لاختيار دقة الالتقاط التي تدعمها الكاميرا.
* `Current Resolution` — تسمية للقراءة فقط تعرض الدقة المستخدمة حالياً.
* `Open Advanced Setting` — زر يفتح نافذة إعدادات البائع المتقدمة (إذا كانت متوفرة على المنصة).

## 🎯 الميزات الرئيسية

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

## 📝 كيفية الاستخدام

1. اضغط زر `Scan Connected USB Cameras` لملء قائمة الكاميرات.
2. اختر الكاميرا المطلوبة من `Select USB Camera`.
3. اختياريًا غيّر `Camera Resolution` وتحقق من تسمية `Current Resolution`.
4. أرسل إشارة `Activate Signal` (true) لبدء تلقي الإطارات عبر `Camera Frame`.
5. عند الانتهاء، أرسل `Release Signal` (true) لتحرير مورد الكاميرا.

## ⚙️ ماذا يحدث عند التشغيل

عند التفعيل، يلتقط البلوك أحدث إطار من الكاميرا المحددة ويخرجه عبر `Camera Frame`. إذا فشلت الكاميرا أو ظهرت إطارات فارغة/تالفة، سيحاول البلوك الاسترداد ويبلغك عبر منطقة الرسائل ومؤشرات الحالة.

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

* عَرض الإخراج الحي بتوصيل `Camera Frame` إلى بلوك `Show Image` لفحص الإطارات وفتح عارض الصور.
* قلّل عبء المعالجة قبل بلوكات الذكاء الاصطناعي بإضافة `Image Resizer` أو `Image Resize` لتصغير الإطارات.
* حسّن جودة الصورة لمهام الكشف بإدراج `Adjust Colors`، `Auto Contrast` أو `Denoising` قبل كاشفات AI.
* استخدم `Image ROI Select` لاقتصاص منطقة محددة وتسريع الكاشفات اللاحقة مثل `Object Detection` أو `Mask Detection`.
* احفظ إطارات مهمة باستخدام `Image Logger` أو سجل فيديو مستمر عبر `Record Video`.
* لاستخراج النص، مرّر الإطارات إلى `OCR` أو `OCR (EasyOCR)` بعد التأكد من التركيز والتباين.
* قبل استخدام `Find Object` أو كاشفات القوالب الأخرى، جرّب `Blur` أو `Image Threshold` لمعالجة المشاهد المزعجة.
* للتخزين أو التسجيل عن بُعد، اقترن مصدر الكاميرا مع `Image Logger` أو `CSV Export` لتخزين البيانات الوصفية مع الإطارات.

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

* لا توجد كاميرات في القائمة: تأكد من توصيل الكاميرا وتغذيتها. أعد توصيل كابل USB أو غيّر المنفذ، ثم اضغط `Scan Connected USB Cameras` مرة أخرى.
* الكاميرا مشغولة أو لا تبدأ: أغلق التطبيقات الأخرى التي قد تستخدم الكاميرا وجرب تحريرها ثم إعادة المسح.
* إطارات فارغة أو تالفة: جرّب اختيار دقة مختلفة عبر `Camera Resolution` أو اضغط زر المسح لإعادة تشغيل الكاميرا. إذا استمرّ المشكلة، افصل الكاميرا وأعد توصيلها.
* الإعدادات المتقدمة غير متاحة: قد تمنع قيود النظام عرض إعدادات البائع؛ راجع ملاحظات المنصة أو استخدم أداة الكاميرا الخارجية.

إذا استمرت المشاكل، جرّب معاينة بسيطة عن طريق توصيل `Camera Frame` إلى `Show Image` لمعرفة ما إذا كانت المشكلة من الهاردوير أو من بلوك معالجة لاحق.