> 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/outputs-exports/output.md).

# Output

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

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

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

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

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

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

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

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

* في بداية التشغيل، يقوم البلوك بمسح الذاكرة المؤقتة للعرض داخليًا حتى يُظهر كل تشغيل إدخالاته الخاصة فقط.
* أثناء التشغيل، تُحوّل كل قيمة واردة إلى تمثيل نصي مُنسق ومُعرَّف بمسافات بادئة (indented) وتُلحَق بالذاكرة المؤقتة.
* في نهاية التشغيل، يُعرض النص المجمّع في `Output Display` لمراجعتك بالتسلسل.

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

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

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

## 📝 طريقة الاستخدام <a href="#usage" id="usage"></a>

1. وصل بلوك مُنتج (مثال: كشف أو معالجة) بمقبس `Generic`.
2. شغّل السيناريو. ستُملأ نافذة `Output Display` بتمثيل قابل للقراءة للبيانات الواردة في التشغيل الحالي.
3. استخدم العرض للتحقق من بنية البيانات، الأعداد، الإحداثيات، والبيانات الوصفية قبل توجيهها إلى تخزين دائم أو بلوكات الشبكة.

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

* استخدم هذا البلوك مع بلوكات الكشف أو التحليل لفحص مخرجاتها بسرعة:
  * وصل مخرجات من `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` لمقارنة ما يتم تسجيله هنا مع ما يظهر في سجلات البرنامج لديك.

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

* لا يظهر شيء في العرض:
  * تأكد من توصيل بلوك مُنتج بمقبس `Generic` وأنه يخرج بيانات أثناء التشغيل.
* السجلات الطويلة جدًا صعبة القراءة:
  * فكر بحفظ البيانات المنظمة باستخدام `CSV Export` أو `Data to JSON` أو إرسالها إلى خادم عبر `REST API - Post` لتحليل ما بعد التشغيل.
* البيانات تبدو مختصرة أو ليست كما هو متوقع:
  * تحقق من نوع إخراج البلوك المنتج (مثل الأعداد، القوائم، القواميس) وافحص ذلك البلوك (مثال: `Object Detection`, `Mask Detection`) للتأكد من أنه ينتج الحقول المتوقعة.