> 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.md).

# Load Image

هذه الدالة (function block) تتيح لك اختيار وفتح ملف صورة واحد من القرص وجعله متاحًا لباقي النظام. توفر منطقة معاينة وعاين سريع لفحص الصورة المحمّلة.

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

لا يحتوي هذا function block على مآخذ إدخال (input sockets).

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

`Image RGB` بيانات الصورة المقروءة من الملف المحدد والمُعرّضة على أنها مخرج البلوك.

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

`Load Image` زر لفتح نافذة اختيار ملف واختيار صورة من القرص.

`See Image` زر لفتح عارض صورة أكبر للفحص.

`Preview Area` منطقة عرض بداخل البلوك تعرض الصورة المحمّلة حاليًا.

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

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

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

* استخدم عنصر التحكم `Load Image` لاختيار ملف. عند اختيار صورة صالحة، تتحدّث المعاينة.
* عند التقييم (evaluation)، يوفر البلوك أحدث صورة عبر مخرج `Image RGB`.
* إذا كانت الصورة مفقودة أو غير صالحة، يعرض البلوك رسالة خطأ في منطقة المعاينة ويصبح المخرج فارغًا.

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

1. اضغط على عنصر التحكم `Load Image` واختر ملف صورة.
2. تأكد من ظهور الصورة في `Preview Area`.
3. استخدم `See Image` لفتح العارض الأكبر إذا احتجت لفحص التفاصيل.
4. اربط مخرج `Image RGB` بالبلوكات الوظيفية الأخرى لمتابعة المعالجة.

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

* معاينة وعملية فحص سريعة
  * اجمعها مع `Show Image` لوضع معاينة الصورة حيث تريد داخل تدفق السيناريو.
* المعالجة المسبقة قبل التحليل
  * إذا كانت الصورة كبيرة أو تحتاج معالجة أسرع، أضف `Image Resizer` بعد هذا البلوك.
  * لمهام مطابقة الكائنات، اقتطع الصورة المحمّلة أولًا باستخدام `Image ROI Select` أو `Image ROI` للتركيز على منطقة أصغر.
* سلاسل الكشف والتعرّف
  * لمهام على مستوى الكائنات، مرّر المخرج إلى `Find Object`, `Object Detection`, أو `Object Detection - Custom`.
  * لمهام OCR، اربط إلى `OCR` أو `OCR (EasyOCR)` بعد أي قص أو تحسين مطلوب.
  * لتحليل الوضعية أو اليدين، اربط إلى `Skeleton Estimation`, `Pose Estimation`, أو `Hand Pose Estimation`.
* تحسين الجودة المرئية أو فصل المقدّم عن الخلفية
  * استخدم `Background Removal (RMBG-1.4)` أو `Background Removal (BiRefNet)` لعزل العناصر الأمامية قبل المعالجة اللاحقة.
* الحفظ والتسجيل
  * احفظ الصور المعالجة أو لقطات الشاشة لاحقًا باستخدام `Image Write`, `Image Logger`, أو `Multi Image Write`.
  * للتصدير المهيكل للنتائج، أضف `CSV Export` أو `Image Logger` حسب الحاجة.

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

* لا تظهر صورة بعد اختيار ملف
  * تأكد أن مسار الملف يشير إلى صورة موجودة وأن التنسيق مدعوم.
  * حاول إعادة فتح الملف باستخدام عنصر التحكم `Load Image`.
* المعاينة تظهر خطأ أو صورة فارغة
  * سيعرض البلوك رسالة خطأ في منطقة المعاينة عند عدم وجود صورة صالحة. أعد تحميل الملف أو اختر ملفًا آخر.
* تباطؤ أو فشل البلوكات التالية مع الصور الكبيرة
  * أدخل `Image Resizer` لتقليل الحجم قبل تمرير الصورة إلى البلوكات الثقيلة في المعالجة.
* تريد تحليل جزء محدد من الصورة فقط
  * اقصر باستخدام `Image ROI Select` ثم مرّر النتيجة المقتطعة إلى بلوكات التحليل مثل `Find Object` أو `Histogram On Line`.

إذا احتجت مساعدة في اختيار البلوك التالي بعد هذا البلوك، جرّب الجمع بين `Show Image`, `Image Resizer`, `Image ROI Select`، ثم أحد بلوكات الكشف أو التحليل (مثال: `Find Object`, `Object Detection`, `OCR`) بناءً على تطبيقك.