> 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/data-matrix-reader2.md).

# Data Matrix Reader2

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

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

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

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

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

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

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

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

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

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

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

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

1. قدّم مصدر صورة إلى `Data Matrix Image` — مثلاً من بلوك الكاميرا أو صورة محملة.
2. اختياريًا عدّل `Timeout` لإعطاء وقت أطول لقراءات صعبة.
3. استخدم مخرج `Data` للوصول إلى القيم المفكوكة لتسجيلها، عرضها، أو معالجتها لاحقًا.

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

* إذا كان الرمز في منطقة صغيرة، قم بقصها أولًا باستخدام `Image ROI Select` حتى يعالج البلوك المنطقة ذات الصلة فقط.
* حسن قابلية القراءة بتغيير حجم الصورة عبر `Image Resize` لزيادة عدد بكسلات الرمز.
* نظف الصور المشوشة باستخدام `Blur` أو `Denoising` أو `Image Adaptive Threshold` قبل إدخالها إلى هذا البلوك.
* استخدم `Show Image` لمعاينة الإطار الذي يُحلل أثناء ضبط عمليات المعالجة المسبقة.
* احفظ إطارات أمثلة باستخدام `Image Logger` أو `Image Write` للتحليل وضبط الإعدادات لاحقًا خارجياً.
* إن كنت تتوقع أنواع رموز أخرى (QR، باركود خطي)، جرّب `Barcode Reader` كبديل لتلك الصيغ.
* إذا كانت الرموز قد تكون مائلة أو مدوّرة، جرّب `Image AutoRotator` أو قص اتجاهات مختلفة عبر أدوات ROI.

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

* لا توجد قيم مفكوكة: تحقّق من الإضاءة والتباين، واقتصِ الإطار إلى الرمز عبر `Image ROI Select`، زد `Timeout`، أو كَبّر الصورة بـ `Image Resize`.
* نص جزئي أو مشوّه: تأكد أن الرمز ليس ضبابيًا — جرّب إزالة `Blur` أو استخدم إدخال بدقة أعلى.
* سلبية كاذبة بسبب خلفيات ضوضائية: طبّق `Image Adaptive Threshold` أو مرشحات أخرى لتحسين فصل المقدمة عن الخلفية.
* عدة رموز لكن بعضُها فقط مفكوك: عالج كل ROI على حدة أو ازد من قيمة `Timeout` وحسّن جودة الصورة للرموز المفقودة.