> 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/ai-blocks/ocr-easyocr.md).

# OCR (EasyOCR)

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

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

`Image` صورة رمادية أو ملونة تحتوي على نص المطلوب التعرف عليه.

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

`Result` صورة مشروحة تحتوي على صناديق النصوص المكتشفة وتسميات نصية اختيارية.

`Whole Text` كل النصوص المعترف بها مدموجة كسلسلة واحدة.

`Texts` قائمة بمقاطع النص المعترف بها.

`Boxes` قائمة بصناديق مضلعية لكل نص مُكتشف (4 نقاط لكل مربع).

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

`Use auto rotation` تفعيل محاولات تدوير الصورة (90°، -90°، 180°) لتحسين الكشف عن النصوص المائلة.

`Show Texts` تبديل عرض تسميات النص المعترف به على صورة `Result` المشروحة.

`Threshold` شريط تمرير عتبة الثقة لتصفية اكتشافات النص ذات الثقة المنخفضة (0–100%).

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

* كشف متعدد الزوايا: يحاول تدويرات بسيطة للتعامل مع النصوص المائلة عند تفعيل `Use auto rotation`.
* ترشيح بالثقة: إزالة الاكتشافات الضعيفة عن طريق ضبط `Threshold`.
* مخرج بصري: يعيد صورة `Result` مشروحة بصناديق وتسميات نصية اختيارية عند وجود اكتشافات.
* يعيد كل من النص المجمع `Whole Text` والمقاطع الفردية `Texts` و`Boxes` للمعالجة اللاحقة.

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

1. قم بتوصيل بلوك إنتاج الصورة إلى مأخذ `Image`.
2. اختياريًا فعّل `Use auto rotation` إذا كانت الصور المصدر قد تكون مائلة.
3. اضبط `Threshold` لموازنة الحساسية مقابل الاكتشافات الخاطئة.
4. فعّل `Show Texts` إذا رغبت في رسم تسميات النص على صورة `Result`.
5. استخدم المخرجات لحفظ، تسجيل، أو معالجة النص المعترف به وإحداثيات المربعات لاحقًا.

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

عند التشغيل، تقوم الكتلة بتحليل الصورة المدخلة (ومتغيرات التدوير إن كانت مفعلة)، وتصفية الاكتشافات حسب `Threshold`، وتعيد الصورة المشروحة (إن وُجدت)، النص الكامل المدموج، قائمة مقاطع النص، وقائمة الصناديق المضلعية.

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

* قم بعمل معالجة مسبقة للصور منخفضة الجودة باستخدام `Image Resizer` أو `Super Resolution` لتحسين التعرف على النصوص الصغيرة أو الضبابية.
* قم بقص منطقة النص أولًا باستخدام `Image ROI Select` أو `Image ROI` حتى يركز البلوك على المناطق ذات الصلة.
* قلل الفوضى في الخلفية باستخدام `Background Removal (RMBG-1.4)` أو `Background Removal (BiRefNet)` قبل OCR عندما يكون النص على خلفيات معقدة.
* حسّن التباين وقابلية القراءة باستخدام `Auto Contrast`، `Adjust Colors`، `Denoising`، أو `Image Threshold` حسب نوع المدخل.
* لفحص مباشر، وجّه `Result` إلى `Show Image` لمعاينة الاكتشافات المشروحة.
* احفظ صور الاكتشاف أو السجلات باستخدام `Image Logger`، `Image Write`، أو صدر النص المعترف به باستخدام `Data to JSON` أو `CSV Export`.
* إذا احتجت سلوك OCR بديلًا، قارن النتائج مع البلوك العام `OCR` أو ادمجه مع `Draw Detections` لتغطية مرئية مخصصة.

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

* لا يوجد نص مكتشف: خفّض `Threshold` وتأكد أن الصورة المدخلة ليست صغيرة جدًا — جرّب `Image Resizer` أو `Super Resolution`.
* إيجابيات كاذبة أو نص مشوش: زد من قيمة `Threshold` وطبق `Denoising` أو `Auto Contrast` لتثبيت المدخلات.
* النص المائل غير مكتشف: فعّل `Use auto rotation` لمحاولة التدويرات الشائعة، أو قم بمحاذاة مسبقة باستخدام `Auto Alignment` إذا كان لديك مرجع.
* الكثير من الاكتشافات الصغيرة: اقص المنطقة ذات الاهتمام باستخدام `Image ROI Select` وصفِّ النتائج حسب حجم صندوق الحدود في البلوكات اللاحقة.