For the complete documentation index, see llms.txt. This page is also available as Markdown.

Barcode Reader

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

📥 مدخلات

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

📤 مخرجات

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

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

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

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

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

🎨 الميزات

  • فك ترميز سريع للباركود و QR من إدخال صورة واحد.

  • ملاحظات بصرية عبر الصورة المعنونة لتأكيد موقع الاكتشاف.

  • يعيد كل من البيانات المفككة ونوع الرمز المكتشف لمعالجة لاحقة.

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

  1. زود صورة إلى مدخل Barcode Image من أي بلوك ينتج صورة (مثلاً كاميرا أو محمل صور).

  2. تفقد خرج Barcode Image بصريًا للتحقق من الاكتشاف.

  3. استخدم خرجَي Barcode Type وBarcode Data لتشغيل منطق، تسجيل، أو تخزين البيانات.

📊 التقييم

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

💡 نصائح وحيل

  • اجمع هذا البلوك مع Image ROI Select لاقتصاص المنطقة حول الملصق أو العبوة قبل إرسالها إلى البلوك. الاقتصاص يقلل من الاكتشافات الخاطئة ويسرع المعالجة.

  • إذا كان الباركود صغيرًا أو منخفض التباين، جرب Image Resize لتكبير المنطقة قبل فك الترميز.

  • استخدم Blur بحذر لتقليل الضوضاء عندما تكون الصور محببة؛ في بعض الحالات يساعد التمويه الخفيف على تحسين الاكتشاف.

  • عندما تُطبَع الرموز على خلفيات معقدة، تطبيق Image Threshold قد يزيد التباين بين الرمز والخلفية.

  • عاين النتائج باستخدام Show Image لتأكيد الاكتشاف والحدود البصرية في واجهة المستخدم.

  • لتسجيل تلقائي للقيم المفككة، أرسل Barcode Data إلى CSV Export أو احفظ الإطارات باستخدام Image Logger لسجلات التدقيق.

  • لمعالجة دفعات أو ملفات، حمّل الصور باستخدام Load Image From Path ومرّرها عبر هذا البلوك.

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

  • عدم اكتشاف أي رمز

    • تأكد أن منطقة الباركود واضحة وليست متblur شديدة أو مغطاة أو صغيرة جدًا.

    • جرّب اقتصاص المنطقة باستخدام Image ROI Select وزيادة حجم الصورة عبر Image Resize.

    • حسّن التباين باستخدام Image Threshold أو ضبط الإضاءة في خطوة الالتقاط.

  • بيانات غير صحيحة أو مشوشة

    • تحقق من جودة الصورة ومحاذاة الرمز. الانقلاب أو تشويه المنظور قد يعيق فك الترميز — قم باقتصاص ومحاذاة المنطقة أولًا.

    • إذا تداخلت عدة رموز، عزلها باستخدام Image ROI Select أو عوامل تصفية المعالجة المسبقة.

  • الكثير من النتائج الخاطئة الإيجابية

    • قيد منطقة الإدخال عبر Image ROI Select أو أضف فلترة بسيطة (عتبة، مرشحات لونية) قبل فك الترميز.

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

آخر تحديث