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

Data Matrix Reader2

هذا البلوك الوظيفي يقوم بفك تشفير رموز Data Matrix من صورة ويعيد النصوص المفكوكة. مناسب لقراءة رمز واحد أو عدة رموز Data Matrix موجودة في نفس الإطار.

📥 المدخلات

Data Matrix Image — قدّم صورة (تدرج رمادي أو ملونة) تحتوي على رموز Data Matrix ليتم فك تشفيرها.

📤 المخرجات

Data — يعيد قائمة بالنصوص المفكوكة الموجودة في الصورة المدخلة.

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

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

⚙️ آلية التشغيل

عند تشغيل البلوك، يقوم بتحليل الصورة المدخلة بحثًا عن رموز Data Matrix ويحاول فك تشفير كل رمز ضمن المهلة المحددة بـ Timeout. إذا تم العثور على رموز، تُعاد قيمها النصية عبر مخرج Data على شكل قائمة. إذا لم تُعثر أي رموز، يُعاد قائمة فارغة.

🎯 الميزات

  • يكتشف ويفك تشفير عدة رموز Data Matrix من صورة واحدة.

  • يعيد القيم المفكوكة كنصوص بسيطة لتسهيل الاستخدام اللاحق.

  • تحكم بسيط بالمهلة (Timeout) لموازنة السرعة ودقة الكشف.

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

  1. قدّم مصدر صورة إلى Data Matrix Image — مثلاً من بلوك الكاميرا أو صورة محملة.

  2. اختياريًا عدّل Timeout لإعطاء وقت أطول لقراءات صعبة.

  3. استخدم مخرج Data للوصول إلى القيم المفكوكة لتسجيلها، عرضها، أو معالجتها لاحقًا.

💡 نصائح وحيل

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

  • حسن قابلية القراءة بتغيير حجم الصورة عبر Image Resize لزيادة عدد بكسلات الرمز.

  • نظف الصور المشوشة باستخدام Blur أو Denoising أو Image Adaptive Threshold قبل إدخالها إلى هذا البلوك.

  • استخدم Show Image لمعاينة الإطار الذي يُحلل أثناء ضبط عمليات المعالجة المسبقة.

  • احفظ إطارات أمثلة باستخدام Image Logger أو Image Write للتحليل وضبط الإعدادات لاحقًا خارجياً.

  • إن كنت تتوقع أنواع رموز أخرى (QR، باركود خطي)، جرّب Barcode Reader كبديل لتلك الصيغ.

  • إذا كانت الرموز قد تكون مائلة أو مدوّرة، جرّب Image AutoRotator أو قص اتجاهات مختلفة عبر أدوات ROI.

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

  • لا توجد قيم مفكوكة: تحقّق من الإضاءة والتباين، واقتصِ الإطار إلى الرمز عبر Image ROI Select، زد Timeout، أو كَبّر الصورة بـ Image Resize.

  • نص جزئي أو مشوّه: تأكد أن الرمز ليس ضبابيًا — جرّب إزالة Blur أو استخدم إدخال بدقة أعلى.

  • سلبية كاذبة بسبب خلفيات ضوضائية: طبّق Image Adaptive Threshold أو مرشحات أخرى لتحسين فصل المقدمة عن الخلفية.

  • عدة رموز لكن بعضُها فقط مفكوك: عالج كل ROI على حدة أو ازد من قيمة Timeout وحسّن جودة الصورة للرموز المفقودة.

آخر تحديث