> 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/data-inputs/text.md).

# Text

هذه الدالة تتيح لك وضع نص قابل للتعديل مباشرة على لوحة المشهد. إنها أداة توثيق/تعليقات خفيفة للعرض النصي ومناسبة للتسميات، الملاحظات أو التعليمات داخل تخطيط السيناريو.

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

لا يحتوي هذا الدالة على أي مقابس إدخال.

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

لا يحتوي هذا الدالة على أي مقابس إخراج.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

`Text` مساحة نصية قابلة للتحرير متعددة الأسطر حيث يمكنك كتابة وتنسيق النص الذي يظهر على لوحة المشهد.

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

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

## 📝 إرشادات الاستخدام <a href="#usage" id="usage"></a>

1. اسحب البلوك إلى لوحة المشهد.
2. انقر داخل منطقة `Text` واكتب رسالتك.
3. حرّك أو غيّر حجم البلوك على اللوحة لوضع النص في المكان الذي يوضح التخطيط أو تدفق العملية بأفضل شكل.

## 📊 التقييم / سلوك وقت التشغيل <a href="#evaluation" id="evaluation"></a>

هذا البلوك مخصص للعرض والتوثيق داخل المحرر. لا يشارك في تدفق البيانات أو المعالجة — لا يقبل مدخلات ولا ينتج مخرجات أثناء تشغيل السيناريو.

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

* استخدم هذا البلوك لترك تعليمات قصيرة للمشغلين أو ملاحظات حول المدخلات والمخرجات المتوقعة بالقرب من البلوكات ذات الصلة مثل `Show Image` أو `Write Text On Image`.
* اجمعه مع `Write Text On Image` إذا أردت أن يظهر نفس النص على اللوحة (للتوثيق) وعلى الصور الفعلية أثناء المعالجة أو التصدير.
* استخدمه مع `Image Logger` أو `Image Write` للإشارة إلى قواعد تسمية أو ملاحظات تسجيل مباشرة على المشهد، مما يساعدك على تتبع الملفات المحفوظة.
* للحصول على إدخال تفاعلي يُغذى إلى خطوط المعالجة، اقترن بـ `String Input` بحيث يمكنك العرض والاستخدام نفسه تلقائياً داخل خطوات المعالجة.

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

* إذا كان النص صعب القراءة على اللوحة، انقل البلوك إلى منطقة واضحة أو غيّر حجمه لتحسين الوضوح.
* إذا توقعت أن يؤثر النص على المعالجة، تذكّر أن هذا البلوك لا يخرج بيانات؛ استخدم `String Input` أو `Write Text On Image` للنص الذي يجب أن تستهلكه بلوكات أخرى.