> 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/german/function-blocks/detections-shapes/detectors/data-matrix-reader2.md).

# Data Matrix Reader2

Dieser Funktionsblock dekodiert Data-Matrix-Codes aus einem Bild und gibt die decodierten Textwerte zurück. Er eignet sich zum Lesen eines oder mehrerer Data-Matrix-Symbole, die in einem Frame vorhanden sind.

## 📥 Eingänge

`Data Matrix Image`\
Geben Sie ein Bild (Graustufen oder Farbe) an, das Data-Matrix-Symbole zur Dekodierung enthält.

## 📤 Ausgänge

`Data`\
Diese Ausgabe liefert eine Liste der im Eingangsbild gefundenen decodierten Textzeichenfolgen.

## 🕹️ Steuerungen

`Timeout`\
Zeitlimit in Millisekunden, wie lange auf die Dekodierung gewartet werden soll. Eine Erhöhung gibt dem Block mehr Zeit, schwache oder schwierige Symbole zu erkennen.

## ⚙️ Funktionsweise

Wenn der Block ausgeführt wird, untersucht er das bereitgestellte Bild auf Data-Matrix-Symbole und versucht, jedes innerhalb des konfigurierten `Timeout` zu dekodieren. Werden Symbole gefunden, werden deren decodierte Textwerte als Liste über die Ausgabe `Data` zurückgegeben. Werden keine gefunden, wird eine leere Liste zurückgegeben.

## 🎯 Funktionen

* Erkennt und dekodiert mehrere Data-Matrix-Symbole aus einem einzigen Bild.
* Gibt decodierte Werte als Klartextzeichenfolgen zurück, was die Weiterverarbeitung erleichtert.
* Einfache Timeout-Steuerung, um Geschwindigkeit und Erkennungsrobustheit auszubalancieren.

## 📝 Verwendungshinweise

1. Stellen Sie eine Bildquelle für `Data Matrix Image` bereit — z. B. von einem Kamera-Block oder einem geladenen Bild.
2. Optional: Passen Sie `Timeout` an, um bei schwierigen Lesungen mehr Zeit zu erlauben.
3. Verwenden Sie die Ausgabe `Data`, um decodierte Werte für Protokolle, Anzeige oder weitere Verarbeitung zu nutzen.

## 💡 Tipps und Tricks

* Wenn das Zielsymbol in einem kleinen Bereich liegt, schneiden Sie zuerst mit `Image ROI Select` zu, damit der Block nur den relevanten Bereich verarbeitet.
* Erhöhen Sie die Zuverlässigkeit, indem Sie das Eingangsbild mit `Image Resize` vergrößern, sodass das Symbol mehr Pixel enthält.
* Entfernen Sie Bildstörungen mit `Blur`, `Denoising` oder `Image Adaptive Threshold`, bevor Sie das Bild in den Block geben.
* Verwenden Sie `Show Image`, um den exakt analysierten Frame während des Feinabstimmens der Vorverarbeitung anzuzeigen.
* Speichern Sie Beispiel-Frames mit `Image Logger` oder `Image Write` für Offline-Analyse und Feineinstellungen.
* Erwarten Sie andere Code-Typen (z. B. QR oder lineare Barcodes)? Probieren Sie `Barcode Reader` als Alternative für diese Formate.
* Falls Symbole gedreht vorliegen, testen Sie `Image AutoRotator` oder schneiden Sie verschiedene Ausrichtungen mit ROI-Werkzeugen zu.

## 🛠️ Fehlersuche

* Keine decodierten Werte: Überprüfen Sie Beleuchtung und Kontrast, schneiden Sie mit `Image ROI Select` auf das Symbol zu, erhöhen Sie `Timeout` oder vergrößern Sie das Bild mit `Image Resize`.
* Teilweise oder fehlerhafte Texte: Stellen Sie sicher, dass das Symbol nicht unscharf ist — versuchen Sie Rauschreduzierung oder verwenden Sie ein höher auflösendes Eingangsbild.
* Falsche Negative bei verrauschtem Hintergrund: Wenden Sie `Image Adaptive Threshold` oder andere Filter an, um die Trennung von Vorder- und Hintergrund zu verbessern.
* Viele Symbole, aber nur einige decodiert: Verarbeiten Sie jede ROI separat oder erhöhen Sie `Timeout` und verbessern Sie die Bildqualität für die fehlenden Symbole.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/detections-shapes/detectors/data-matrix-reader2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.