> 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/detectors/barcode-reader.md).

# Barcode Reader

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

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

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

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

`Barcode Image` صورة معنونة. عند اكتشاف رمز، تظهر علامات بصرية (مربعات/تسميات) على الصورة.

`Barcode Type` نوع الباركود المكتشف (مثل QR، CODE128، إلخ).

`Barcode Data` البيانات المفككة الموجودة في الباركود أو رمز QR (نص أو أرقام).

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

لا يحتوي هذا البلوك على عناصر تحكم تفاعلية. يعمل تلقائيًا عند تزويده بصورة.

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

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

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

1. زود صورة إلى مدخل `Barcode Image` من أي بلوك ينتج صورة (مثلاً كاميرا أو محمل صور).
2. تفقد خرج `Barcode Image` بصريًا للتحقق من الاكتشاف.
3. استخدم خرجَي `Barcode Type` و`Barcode Data` لتشغيل منطق، تسجيل، أو تخزين البيانات.

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

عند استلام صورة، يقوم البلوك بتحليل الإطار بحثًا عن أنماط الباركود. إذا تم العثور على رمز، يعيد البلوك صورة معنونة، نوع الرمز المكتشف، والبيانات المفككة. إذا لم يُكتشف شيء، تُعاد الصورة المعنونة دون تغيير وتشير مخرجات البيانات إلى عدم وجود اكتشاف.

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

* اجمع هذا البلوك مع `Image ROI Select` لاقتصاص المنطقة حول الملصق أو العبوة قبل إرسالها إلى البلوك. الاقتصاص يقلل من الاكتشافات الخاطئة ويسرع المعالجة.
* إذا كان الباركود صغيرًا أو منخفض التباين، جرب `Image Resize` لتكبير المنطقة قبل فك الترميز.
* استخدم `Blur` بحذر لتقليل الضوضاء عندما تكون الصور محببة؛ في بعض الحالات يساعد التمويه الخفيف على تحسين الاكتشاف.
* عندما تُطبَع الرموز على خلفيات معقدة، تطبيق `Image Threshold` قد يزيد التباين بين الرمز والخلفية.
* عاين النتائج باستخدام `Show Image` لتأكيد الاكتشاف والحدود البصرية في واجهة المستخدم.
* لتسجيل تلقائي للقيم المفككة، أرسل `Barcode Data` إلى `CSV Export` أو احفظ الإطارات باستخدام `Image Logger` لسجلات التدقيق.
* لمعالجة دفعات أو ملفات، حمّل الصور باستخدام `Load Image From Path` ومرّرها عبر هذا البلوك.

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

* عدم اكتشاف أي رمز
  * تأكد أن منطقة الباركود واضحة وليست متblur شديدة أو مغطاة أو صغيرة جدًا.
  * جرّب اقتصاص المنطقة باستخدام `Image ROI Select` وزيادة حجم الصورة عبر `Image Resize`.
  * حسّن التباين باستخدام `Image Threshold` أو ضبط الإضاءة في خطوة الالتقاط.
* بيانات غير صحيحة أو مشوشة
  * تحقق من جودة الصورة ومحاذاة الرمز. الانقلاب أو تشويه المنظور قد يعيق فك الترميز — قم باقتصاص ومحاذاة المنطقة أولًا.
  * إذا تداخلت عدة رموز، عزلها باستخدام `Image ROI Select` أو عوامل تصفية المعالجة المسبقة.
* الكثير من النتائج الخاطئة الإيجابية
  * قيد منطقة الإدخال عبر `Image ROI Select` أو أضف فلترة بسيطة (عتبة، مرشحات لونية) قبل فك الترميز.

إذا رغبت في معاينة إطارات الصورة بصريًا أثناء الإعداد، اربط الخرج إلى `Show Image` لتتأكد كيف يقوم البلوك بتمييز الرموز المكتشفة.