> 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/detections-shapes/draw/write-date-on-image.md).

# Write Date On Image

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

## 📥 المدخلات

* `Image Any` — الصورة التي سيُضاف عليها الطابع الزمني (أي صورة ملونة أو أحادية العمق).

## 📤 المخرجات

* `Image Any` — الصورة نفسها مع كتابة التاريخ/الوقت عليها.

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

* `Font Scale` — يضبط الحجم النسبي للنص. يتدرج تلقائياً مع أبعاد الصورة حتى يظل النص متناسقاً.
* `Horizontal Position` — يحرك النص أفقياً عبر الصورة (شريط منزّل مُطبّع).
* `Vertical Position` — يحرك النص عمودياً عبر الصورة (شريط منزّل مُطبّع).
* `Font Thickness` — يغير سمك حواف النص.
* `Text Background` — تفعيل مستطيل خلفي مملوء خلف النص لتحسين التباين والقراءة.
* `Font` — اختيار نمط الخط من الخيارات المتاحة (مثلاً Simplex, Duplex, Script).
* `Color` — اختيار لون النص من لوحة ألوان مُعدة مسبقاً.

## 🎨 الميزات

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

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

1. وصل بلوك مُنتج للصورة بمُدخل `Image Any`.
2. عدّل `Font Scale` و`Horizontal Position` و`Vertical Position` لوضع الطابع الزمني في المكان المطلوب.
3. اختر `Font` و`Color` واضحين فوق الصورة.
4. اختياريًا فعّل `Text Background` لضمان وضوح النص على خلفيات معقّدة.
5. شغّل التدفق؛ سيخرج البلوك الصورة مع التاريخ/الوقت الحالي مطبوعين عليها.

يُستخدم تنسيق تاريخ-وقت مضغوط (التاريخ والوقت معاً) ليكون مناسباً لأسماء الملفات وفحص سريع بالعين.

## 📊 التقييم

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

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

* للمعاينة في واجهة المحرر، اربط المخرج ببلوك `Show Image`.
* لحفظ صور كثيرة مؤرخة، اجمع هذا البلوك مع `Image Logger` أو `Image Write` لتخزين الصور مع الطابع الزمني.
* في تدفقات تسجيل الفيديو، أرسل المخرج إلى `Record Video` ليحتوي كل إطار مسجّل على الطابع الزمني.
* عند التعامل مع صور كبيرة جداً، استخدم `Image Resize` قبل هذا البلوك لتقليل زمن المعالجة مع الحفاظ على نص قابل للقراءة.
* إذا رغبت بإضافة معلومات أخرى (مثل معرفات أو عدّادات) مع التاريخ، اجمع هذا البلوك مع بلوكات تُنتج نصوصاً أو أرقاماً وطبق خطوات كتابة متعددة.

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

* النص يظهر خارج الإطار: عدّل `Horizontal Position` و`Vertical Position` لإعادة النص داخل الصورة.
* النص صعب القراءة على خلفية مزدحمة: فعّل `Text Background` أو اختر `Color` متباين.
* النص صغير جداً أو كبير جداً: ضبط `Font Scale` و/أو `Font Thickness` حتى يصبح مقروءاً.
* بطء في المعالجة على صور كبيرة: أدخل بلوك `Image Resize` قبل هذا البلوك، أو قُم بتصغير الصورة ثم كتابة التاريخ.