> 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/basler-camera.md).

# Basler Camera

تقوم هذه الدالة بالاتصال بكاميرا Basler وتزويد السيناريو بإطارات حية. تم تصميمها لكاميرات صناعية وتوفر إعدادات شبكة ومهلات زمنية مناسبة للحصول على إطارات موثوقة.

## 📥 المدخلات

لا يتطلب هذا البلوك أي مقابس إدخال.

## 📤 المخرجات

`Image`\
أحدث إطار من الكاميرا. إذا كانت الكاميرا غير متاحة فستكون هذه المخرجات فارغة (None) حتى يمكن استرجاع إطار.

## 🕹️ الضوابط

* `IP Address`\
  أدخل عنوان IP الخاص بالكاميرا. اتركها فارغة للمحاولة على أول كاميرا Basler يتم اكتشافها على الشبكة.
* `NAT Address`\
  اختياري. استخدمه عندما تكون الكاميرا قابلة للوصول عبر عنوان NAT مختلف عن IP الكاميرا.
* `Destination Address`\
  اختياري. استخدمه عندما ترسل الكاميرا بثًا متعدد الوجهات (multicast) أو تكون موجهة إلى عنوان جهاز كمبيوتر محدد.
* `Trigger Ready Timeout (ms)`\
  أقصى مدة انتظار (بالملي ثانية) قبل إرسال تريجر برمجي إلى الكاميرا.
* `Retrieve Result Timeout (ms)`\
  أقصى مدة انتظار (بالملي ثانية) لاستلام الإطار بعد إرسال التريجر.

ملاحظة: سيحاول البلوك إعادة الاتصال تلقائيًا عند تغيير المعاملات. استخدم الضوابط أعلاه لتكوين الاتصال والمهلات الزمنية.

## 🎨 الميزات

* اتصال موثوق بكاميرات Basler مع دعم لـ IP و NAT.
* ضوابط زمنية (Timeout) لضبط سرعة الاستجابة عند وجود تأخيرات في الشبكة أو الكاميرا.
* إعادة اتصال تلقائية عند تغيير المعاملات أو حدوث أعطال مؤقتة.
* يخرج أحدث إطار في الوقت الفعلي للمعالجة اللاحقة.

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

1. املأ `IP Address` إذا كنت تعرف عنوان الكاميرا. بخلاف ذلك اتركها فارغة لاستخدام أول كاميرا Basler متاحة.
2. اختياريًا عيّن `NAT Address` أو `Destination Address` إذا كانت شبكتك تتطلب ذلك.
3. قم بضبط `Trigger Ready Timeout (ms)` و/أو `Retrieve Result Timeout (ms)` إذا واجهت تأخيرات.
4. أضف بلوكات لاحقة تستهلك مخرج `Image` لبناء خط المعالجة الخاص بك.

## 📊 التقييم

عند التشغيل، سيزودك هذا البلوك بأحدث إطار من كاميرا Basler المكوَّنة على مخرج `Image`. إذا تعذّر الوصول إلى الكاميرا أو استرجاع إطار، ستبقى المخرجات فارغة حتى يتم استعادة الاتصال.

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

* اعرض الإطارات بسرعة بتوصيل مخرج `Image` إلى `Show Image`.
* احفظ الإطارات أو التسلسلات الملتقطة باستخدام `Image Logger` أو `Record Video` للمراجعة فيما بعد.
* إذا كانت بلوكات الذكاء الاصطناعي تعاني مع إطارات كبيرة جدًا، أدرج `Image Resizer` قبل المعالجة الثقيلة لتقليل حجم الصورة وتحسين الأداء.
* لمهام الكشف أو التفتيش، اقترن بـ `Object Detection` أو `Object Detection - Custom` أو `Mask Detection` لتحليل الإطارات الحية.
* استخدم `Super Resolution` بعد الالتقاط عندما تحتاج إلى تفاصيل بصرية محسّنة للتحليل اللاحق.
* قص أو ركز على مناطق الاهتمام باستخدام `Image ROI Select` أو `Image ROI` قبل تطبيق الكواشف لتقليل الإيجابيات الكاذبة وتسريع المعالجة.

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

* إذا لم تظهر أي إطارات، تحقق من اتصال الشبكة وأن الكاميرا موصولة وموجودة على العنوان المكوّن.
* إذا كانت الإطارات متأخرة أو تنتهي مهلة الانتظار، زد قيمة `Trigger Ready Timeout (ms)` و/أو `Retrieve Result Timeout (ms)`.
* إذا استمر فشل الاتصال بعد تغيّر المعاملات، تحقق من العناوين وحاول إعادة تشغيل جهاز الكاميرا أو معدات الشبكة.