> 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/image-inputs/load-image-from-path.md).

# Load Image From Path

تحميل بيانات الصورة من مسار نظام الملفات. يمكنك إما تزويد المجلد واسم الملف بشكل منفصل أو إدخال المسار الكامل للملف في المدخل الأول. مصمم لتوفير إدخالات صور بسيطة وموثوقة في مسار المعالجة الخاص بك.

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

* `Folder Path` (مدخل)\
  المسار الكامل للمجلد الذي يحتوي على ملفات الصورة. يمكنك أيضًا إدخال مسار ملف كامل هنا؛ في هذه الحالة اترك `File Name` فارغًا.
* `File Name` (مدخل)\
  اسم الملف الاختياري الذي يُدمج مع `Folder Path`. عند تركه فارغًا، يعتبر البلوك المدخل الأول كالمسار الكامل للملف.

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

* `Image` (مخرج)\
  الصورة المحمّلة. إذا فشل التحميل، سيظهر المخرج صورة مفقودة أو فارغة (راجع قسم حل المشكلات).

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

* حقل إدخال `Folder Path` (نص)
* حقل إدخال `File Name` (نص)

هاتان الحقول تظهران كعناصر تحكم مرئية لاختيار الملف المراد تحميله. تزويد `Folder Path` بمسار كامل هو أبسط طريقة لتحميل ملف واحد.

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

* يقبل إما زوج مجلد + اسم ملف أو مسار ملف كامل واحد لسهولة الاستخدام.
* يعمل مع صيغ الصور الشائعة المدعومة من النظام.
* مصمم ليُدمج بسهولة مع كتل المعاينة، الحفظ والمعالجة المسبقة في مسارك.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. ضع المجلد الذي يحتوي الصورة في مدخل `Folder Path`.
2. اختياريًا ضع اسم الملف في مدخل `File Name`. إذا لصقت مسارًا كاملاً في `Folder Path` اترك `File Name` فارغًا.
3. استخدم مخرج `Image` كمصدر لمعالجة لاحقة أو للمعاينة.

## ⚙️ التقييم <a href="#evaluation" id="evaluation"></a>

عند تقييم البلوك، سيحاول تحميل الصورة المشار إليها بالمدخلات ويخرج الصورة لاستخدامها بواسطة البلوكات التالية.

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

* عاين الصورة المحمّلة باستخدام `Show Image` للتأكد من اختيار الملف الصحيح قبل المتابعة في المعالجة.
* عند معالجة صور كبيرة أو تغذية بلوكات الذكاء الاصطناعي، استخدم `Image Resize` أو `Image Resizer` لتقليل حجم الصورة وتحسين الأداء.
* استخدم `Image ROI Select` أو `Image ROI` لقص الصورة المحمّلة قبل التحليل إذا كنت بحاجة إلى منطقة محددة فقط.
* احفظ الأمثلة أو النتائج باستخدام `Image Write` أو `Image Logger` للحفاظ على سجلات المدخلات/المخرجات.
* إذا كنت بحاجة إلى تحميل العديد من الصور من مجلد، فكّر في استخدام بلوك `Load Image` الذي يتيح اختيار المجلدات والتكرار عبر الصور.
* حسن جودة الصورة قبل التحليل باستخدام `Denoising` أو `Contrast Optimization`.
* لاستخراج النص من الصور المحمّلة، وصل البلوك بـ `OCR` أو `OCR (EasyOCR)` بعد التحقق من الصورة باستخدام `Show Image`.

## 🛠️ حل المشكلات <a href="#troubleshooting" id="troubleshooting"></a>

* الملف غير موجود أو المخرج فارغ
  * تحقق من أن المسار صحيح ويمكن الوصول إليه من الجهاز الذي يشغل النظام.
  * جرّب استخدام مسار مطلق بدلًا من نسبي.
  * إذا كنت تزود `Folder Path` و`File Name` معًا، تأكد أن الجمع بينهما يشير إلى موقع ملف صالح.
* صيغة الصورة غير مدعومة أو الملف تالف
  * افتح الملف في عارض صور خارجي للتأكد من صلاحية الملف.
  * حول الصورة إلى صيغة شائعة (JPEG، PNG) إذا لزم الأمر.
* مشاكل أذونات
  * تأكد أن المستخدم الذي يشغّل النظام لديه صلاحية قراءة للمجلد والملف.

إذا استمرت المشكلة، قم بمعاينة المسار باستخدام `Show Image` أو جرّب تحميل نفس الصورة باستخدام بلوك `Load Image` لاستبعاد مشكلات المسار/الأذونات.