> 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/multi-image-write.md).

# Multi Image Write

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

## 📥 المدخلات

* `Folder Path` مدخل: قدّم المسار الكامل للمجلد حيث سيتم حفظ الصور.
* `File Name` مدخل: ضع اسم الملف الأساسي (بدون الامتداد). يمكن استخدام طابع زمني أو نص مخصص.
* `Write Condition` مدخل: مُشغّل منطقي (Boolean) يبدأ عملية الحفظ عندما يكون True.
* `Input Images` مدخل: يستقبل صورة واحدة أو عدة صور (قائمة). سيتم حفظ كل صورة كملف منفصل.

## 📤 المخرجات

هذا البلوك لا ينتج أي مخرجات.

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

* `Compress Image?` خانة اختيار: عند التفعيل، يتم حفظ الصور بصيغة JPEG بجودة مخفضة لحجم ملف أصغر. عند التعطيل، يتم حفظ الصور بصيغة PNG (بدون فقدان جودة).

## 🎨 الميزات

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

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

1. ضع مسار في `Folder Path` (أو استخدم بلوك اختيار المجلد upstream).
2. اضبط اسم أساسي في `File Name`. استخدم سلسلة زمنية أو عدّاد لتجنب التصادمات.
3. اربط إشارة منطقية إلى `Write Condition`؛ اضبطها على True لتحفيز الحفظ.
4. أدخل صورة واحدة أو أكثر إلى `Input Images`. سيتم كتابة كل صورة إلى القرص باسم أساسي مع لاحقة مؤشر (index).
5. فعّل أو أطفئ `Compress Image?` إذا رغبت بالضغط بصيغة JPEG بدلاً من PNG.

## 📊 التقييم

عندما تكون قيمة `Write Condition` True وتكون المدخلات صالحة، يحاول البلوك حفظ كل صورة في القائمة المقدمة. يتم تسجيل عمليات الحفظ الناجحة؛ وتُبلغ الإخفاقات عن خطأ (مثلاً عند عدم وجود المجلد أو فشل الكتابة على القرص).

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

* استخدم `Choose Folder` لتمكين المستخدمين من اختيار موقع الحفظ تفاعليًا وأوصل مخرجه إلى `Folder Path`.
* ادمجه مع `Date-Time` لإنشاء أسماء ملفات فريدة تلقائيًا (مثلاً طابع زمني في `File Name`).
* إن كنت بحاجة لمعاينة الصور قبل الحفظ، أرسلها أولًا إلى `Show Image`.
* قلل حجم الصورة قبل الحفظ لتوفير المساحة وتسريع الكتابة باستخدام `Image Resize` أو `Image Resizer` في المجرى السابق.
* لحفظ صور متعددة مرتبطة كملخّص بصري واحد، أنشئ ملصقًا باستخدام `Collage Images` ثم احفظ الملصق.
* إذا احتجت إلى تسجيل مستمر للإطارات، فكّر بإقران البلوك مع `Image Logger` لعمليات أرشفة تلقائية.

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

* أخطاء المجلد غير صالح: تأكد أن `Folder Path` موجود وقابل للكتابة. استخدم `Choose Folder` لتجنب الأخطاء المطبعية.
* لم يتم حفظ أي صور: تأكد من اتصال `Input Images` وأن `Write Condition` كانت True عند وقت التنفيذ.
* تنسيقات ملفات تالفة أو غير متوقعة: قم بتبديل حالة `Compress Image?` للتبديل بين JPEG وPNG وتحقق من التوافق في المراحل التالية.
* عدد كبير من الصور يبطئ النظام: قم بتغيير حجم الصور باستخدام `Image Resize` قبل الكتابة أو فعّل الضغط لتقليل عمليات الإدخال/الإخراج على القرص.