Output

تُظهر هذه الدالة تمثيلاً قابلاً للقراءة من قبل الإنسان (مسلسل) للبيانات الواردة إليها. تُستخدم بشكل أساسي لفحص القيم أثناء التشغيل، وتصحيح الأخطاء السريع، وتسجيل خفيف على الشاشة للبيانات المنتجة من قبل دوال أخرى.

📥 المدخلات

Generic مقبس إدخال يقبل أي نوع من البيانات (أرقام، نصوص، قوائم، قواميس، بيانات وصفية للصور، نتائج كشف، إلخ) من بلوكات أخرى.

📤 المخرجات

هذه الدالة لا تُنتج أي مخارج. هي بلوك عرض فقط.

🕹️ عناصر التحكم

Output Display منطقة نصية قابلة لتغيير الحجم تعرض التمثيل المتسلسل للبيانات الواردة. يجمع البلوك المدخلات ويُلحقها في العرض خلال كل تشغيل لكي تتم مراجعتها بسهولة.

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

• في بداية التشغيل، يقوم البلوك بمسح الذاكرة المؤقتة للعرض داخليًا حتى يُظهر كل تشغيل إدخالاته الخاصة فقط.

• أثناء التشغيل، تُحوّل كل قيمة واردة إلى تمثيل نصي مُنسق ومُعرَّف بمسافات بادئة (indented) وتُلحَق بالذاكرة المؤقتة.

• في نهاية التشغيل، يُعرض النص المجمّع في Output Display لمراجعتك بالتسلسل.

هذا يجعل البلوك مفيدًا لمراقبة كيفية تغير البيانات خلال سيناريو بدون الحاجة إلى حفظ ملفات.

✨ الميزات

• تمثيل مقروء ومُنسق (indented) لفحص سريع للهياكل البيانية المعقدة.

• تحويل القيم غير الملائمة للعرض إلى نص قابل للقراءة ليبقى العرض مفيدًا.

• تجميع الإدخالات خلال التشغيل لعرض تسلسل زمني للقيم المنتجة.

• منطقة عرض قابلة لتغيير الحجم للسجلات الطويلة أو تعدد الإدخالات.

📝 طريقة الاستخدام

1. وصل بلوك مُنتج (مثال: كشف أو معالجة) بمقبس Generic.

2. شغّل السيناريو. ستُملأ نافذة Output Display بتمثيل قابل للقراءة للبيانات الواردة في التشغيل الحالي.

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

💡 نصائح وحيل

• استخدم هذا البلوك مع بلوكات الكشف أو التحليل لفحص مخرجاتها بسرعة:

  • وصل مخرجات من Object Detection, Object Detection - Custom, Mask Detection, Pose Estimation, Object_Detection_Tracker أو Find Object لعرض الأعداد والإحداثيات وتفاصيل النتائج بسرعة.

• عندما تريد الحفاظ على البيانات أو إرسالها بعد الفحص، اقترن بالبلاكات التالية:

  • CSV Export لكتابة بيانات جدولية إلى ملفات،

  • Data to JSON لتجميع سجلات JSON منظمة،

  • REST API - Post أو MQTT Publish لإرسال البيانات المفحوصة إلى خوادم أو وسطاء رسائل،

  • Image Logger أو Image Write عندما تحتاج أيضًا إلى حفظ الأدلة البصرية.

• للتصحيح السريع إلى جانب الفحص البصري، استخدم Show Image بالتوازي: تفحص الصور بينما تعرض بيانات الكشف هنا.

• استخدم Debug Input لمقارنة ما يتم تسجيله هنا مع ما يظهر في سجلات البرنامج لديك.

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

• لا يظهر شيء في العرض:

  • تأكد من توصيل بلوك مُنتج بمقبس Generic وأنه يخرج بيانات أثناء التشغيل.

• السجلات الطويلة جدًا صعبة القراءة:

  • فكر بحفظ البيانات المنظمة باستخدام CSV Export أو Data to JSON أو إرسالها إلى خادم عبر REST API - Post لتحليل ما بعد التشغيل.

• البيانات تبدو مختصرة أو ليست كما هو متوقع:

  • تحقق من نوع إخراج البلوك المنتج (مثل الأعداد، القوائم، القواميس) وافحص ذلك البلوك (مثال: Object Detection, Mask Detection) للتأكد من أنه ينتج الحقول المتوقعة.