| Operatoren |
get_data_code_2d_results — Abfrage von alphanumerischen Ergebnissen, die bei der Suche nach 2D-Datacode-Symbolen angefallen sind.
get_data_code_2d_results( : : DataCodeHandle, CandidateHandle, ResultNames : ResultValues)
Der Operator get_data_code_2d_results erlaubt den Zugriff auf verschiedene alphanumerische Ergebnisse, die während der Suche nach 2D-Datacodes oder beim Lesen der gefundenen Symbole anfallen und so die Ergebnisobjekte - das sind alle untersuchten Kandidaten, unabhängig davon, ob sie gelesen werden konnten oder nicht - genauer beschreiben. Die Ergebnisse beziehen sich dementsprechend meist nicht auf die höchste Auflösung des Symbols, sondern hängen von der Pyramidenstufe ab, in der der Leseprozess abgebrochen wird. Für den Zugriff auf die Ergebnisse muss neben dem Namen des gewünschten Ergebnisses (ResultNames) auch das zugrundeliegende 2D-Datacode-Modell (DataCodeHandle) sowie bei den Ergebnissen, die sich auf einen konkreten Symbolkandidaten beziehen, ein entsprechendes Handle (CandidateHandle) angegeben werden.
Für den Fall, dass 'discard_undecoded_candidates' in set_data_code_2d_param auf 'yes' gesetzt wurde, können Ergebnisse nur zu erfolgreich dekodierten Kandidaten abgefragt werden.
Die meisten der Ergebnisse enthalten genau einen Wert. Diese Ergebnisse können für einen konkreten Kandidaten-Handle in einem Aufruf gemeinsam abgefragt werden. Die Werte des Ergebnistupels ResultValues korrespondieren in diesem Fall mit den entsprechenden Parametern in der Eingangsliste ResultNames. Alternativ dazu kann, wenn diese Ergebnisse einzeln abgefragt werden sollen, statt eines konkreten Kandidaten-Handles auch ein String, der eine Gruppe von Kandidaten beschreibt, angegeben werden, wodurch der entsprechende Wert für alle Kandidaten dieser Gruppe gemeinsam zurückgegeben wird.
Des Weiteren gibt es Ergebnisse, die nicht nur einen einzelnen Wert enthalten, sondern ein Wertetupel (z.B. 'bin_module_data'). Diese Ergebnisse müssen stets exklusiv für genau einen Kandidaten abgefragt werden, und die Anfrage kann auch nicht mit anderen Ergebnissen in einem Aufruf kombiniert werden.
Schließlich stehen noch eine Reihe an Information bereit, die sich nicht auf einen konkreten Kandidaten sondern auf die Suche im Allgemeinen beziehen. Für sie wird statt eines Kandidaten-Handles der String 'general' übergeben.
Es ist zu beachten, dass die Symbolstruktur von GS1 DataMatrix, GS1 QR Code und GS1 Aztec Code mit der Struktur von ECC 200, QR Code, bzw. Aztec Code identisch ist. Deswegen können alle Ergebnisse welche typspezifisch für ECC 200, QR Code oder Aztec sind, auch für ihre entsprechende GS1-Variante abgefragt werden. Im Folgenden wird das ausführliche Auflisten typspezifischer Ergebnisse einzelner GS1-Typen ausgelassen, um die Lesbarkeit der Dokumentation zu erleichtern. Stattdessen können die relevante Ergebnisnamen eines GS1-Datacodetyps entweder von den Ergebnisnamen von dessen nicht-GS1-Variante hergeleitet werden oder explizit durch query_data_code_2d_params mit dem Parameter 'get_result_params' abgefragt werden.
Gruppen von Kandidaten
Die folgenden Gruppen von Kandidaten sind vordefiniert und können anstelle eines einzelnen Handles an CandidateHandle übergeben werden:
Dieser CandidateHandle-Wert wird für Parameter verwendet, die sich auf keinen konkreten Kandidaten sondern auf den letzten find_data_code_2d-Aufruf im Allgemeinen beziehen.
Alle Ergebniskandidaten (einschließlich der erfolgreich dekodierten Symbole), die während des letzten Aufrufs von find_data_code_2d untersucht wurden.
Alle Symbole, die während des letzten Aufrufs von find_data_code_2d erfolgreich dekodiert wurden.
All jene Kandidaten des letzten find_data_code_2d-Aufrufs, die als Symbol erkannt aber nicht dekodiert werden konnten. Bei diesen Kandidaten hat die Fehlerkorrektur zu viele Fehler entdeckt. Oder aber das Symbol enthält inkonsistente Daten, sodass beim Dekodieren der bereits fehlerkorrigierten Daten ein Fehler auftrat.
All jene Kandidaten des letzten find_data_code_2d-Aufrufs, bei denen die Identifizierung als gültiges 2D-Datacode-Symbol gescheitert ist und die Suche vorzeitig abgebrochen wurde.
Unterstützte Ergebnisse
Zur Zeit wird über ResultNames der Zugriff auf folgende Ergebnisse unterstützt, die in ResultValues zurückgeliefert werden:
Allgemeine, kandidatenunabhängige Ergebnisse (Alle 2D-Datacode-Modelle) - 'general':
Alle 2D-Datacode-Modelle:
Unterste Pyramidenstufe, in der nach Symbolen gesucht wird. Hierbei entspricht das Originalbild der Pyramidenstufe 0.
Oberste Pyramidenstufe, in der nach Symbolen gesucht wird. Hierbei entspricht das Originalbild der Pyramidenstufe 0.
Gesamtzahl der absolvierten Such-Durchläufe, siehe auch find_data_code_2d (Übersicht über die Funktionsweise der Symbolsuche).
Anzahl der erfolgreich dekodierten Symbole insgesamt.
Anzahl der bearbeiteten Kandidaten insgesamt.
Anzahl der Kandidaten, die als Symbol identifiziert, jedoch nicht gelesen werden konnten.
Anzahl der Kandidaten, bei denen die Bearbeitung vorzeitig abgebrochen wurde, da sie nicht als ein gültiger 2D-Datacode identifiziert werden konnten.
Ob find_data_code_2d im vorangegangenen Durchlauf vorzeitig abgebrochen wurde, kann durch 'timeout_occurred' abgefragt werden. Falls dies zutrifft wird 1 zurückgegeben, andernfalls 0.
Gibt die Namen der Elemente des Qualitätsgradtupels, das von get_data_code_2d_results mit Parameter 'quality_isoiec15415' ausgegeben wird, zurück. Die Namen der Qualitätselemente unterscheiden sich je nach Datacodemodell.
Data Matrix ECC 200, Aztec, QR Code and Micro QR Code:
Gibt die Namen der Elemente des Qualitätsgradtupels, das von get_data_code_2d_results mit Parameter 'quality_aimdpm_1_2006' ausgegeben wird, zurück.
Datamatrix ECC 200:
Gibt die Namen der Elemente des Qualitätstupels, das von get_data_code_2d_results mit Parameter 'quality_semi_t10_values' ausgegeben wird, zurück.
Ergebnisse, die sich auf einen konkreten Kandidaten beziehen - Einzelwert Ergebnisse:
Ergebnisse, die genau einen Wert beinhalten und somit auch für mehrere Kandidaten gleichzeitig abgefragt werden können. Bei diesen Ergebnissen ist zu beachten, dass für Kandidaten, deren Bearbeitung vorzeitig abgebrochen wurde (vgl. Bearbeitungsstatus 'status'), nicht alle Ergebnisse sinnvolle Werte liefern:
Alle 2D-Datacode-Modelle:
Kandidaten-Handle. Dieser Aufruf dient in erster Linie dazu, sich die Handles aller Kandidaten einer der oben beschriebenen Gruppen geben zu lassen.
Nummer des Durchlaufs, in dem der Kandidat gefunden und bearbeitet wurde, siehe auch find_data_code_2d (Übersicht über die Funktionsweise der Symbolsuche).
Der Bearbeitungsstatus zeigt für den Kandidaten an, ob die Dekodierung erfolgreich war oder warum die Bearbeitung abgebrochen wurde.
Pyramidenstufe, in der der Kandidat mit Hilfe des Finderpatterns gefunden wurde.
Pyramidenstufe, in der die weitere Bearbeitung des Kandidaten erfolgte.
Polarität des Symbols. Das ist die Annahme darüber, ob das Symbol im Bild heller oder dunkler als der Hintergrund erscheint.
Angabe, ob ein erfolgreich dekodiertes Symbols gespiegelt ist oder nicht. Bei Kandidaten, die nicht gelesen werden konnten, wird hier die vom Modell vorgegebene Annahme über eine mögliche Spiegelung zurückgegeben.
Bei ECC 200, QR-Code und Azte Code: Ermittelte Symbolgröße in Modulen: Anzahl der Zeilen bzw. der Spalten einschließlich des Finderpatterns; Bei PDF417: Ermittelte Anzahl der Zeilen und Datenspalten (je 17 Module) im Symbol. Weder die Start/Stop-Patterns noch die Row-Indicators werden dabei mitgezählt.
Größe der Module in Pixel in Richtung der Symbolzeilen bzw. Symbolspalten.
Robustheit der Dekodierung gegenüber Datacodes mit sehr kleiner Modulgröße. Für 'low' wurde der Datacode mit einem Verfahren dekodiert, das nur eine geringe Robustheit gegenüber sehr kleinen Modulgrößen aufweist. Für 'high' wurde der Datacode mit einem Verfahren dekodiert, das diesbezüglich eine hohe Robustheit aufweist.
Schätzung des Kontrastes innerhalb des Symbols. Dieser Wert basiert auf den Gradienten der Kanten zwischen Finderpattern und Hintergrund.
Im Symbol kodierter String - die Abfrage ist nur für erfolgreich dekodierte Kandidaten sinnvoll und liefert das gleiche Ergebnis wie find_data_code_2d.
Dekodierungsfehler - bei erfolgreich dekodierten Symbolen steht hier die Anzahl der von der Fehlerkorrektur gefundenen und korrigierten Fehler, d.h. der Codewörter, bei deren Lesen zunächst Probleme auftraten. Für den PDF417 beinhaltet dieser Wert auch Auslöschungen (Erasures), d.h. Fehler deren Postition bekannt ist. Für Symbole, bei denen die Fehlerkorrektur scheiterte, steht hier ein negativer Fehlercode.
Der Symbology Identifier wird verwendet um anzuzeigen, dass der Datacode das FNC1- und/oder ECI-Zeichen enthält.
Das Zeichen FNC1 (Function 1 Character) wird verwendet, wenn die Daten in dem Symbol entsprechend spezieller vordefinierter Industrie- oder Anwendungsnormen formatiert sind.
Das ECI-Protokoll (Extended Channel Interpretation) wird im Zusammenhang mit einem 6-stelligen Code verwendet, wenn die nachfolgenden Zeichen entsprechend spezieller Codetabellen, beispielsweise mit einem bestimmten internationalen Zeichensatz, zu interpretieren sind. Im Ausgabestrom werden sie als '\nnnnnn' kodiert. Enthält das Symbol ein oder mehrere ECI-Codes, werden alle Backslashs ('\', ASCII-Code 92), die im normalen Datenstrom auftreten, verdoppelt
Als Identifier wird hier nur der eigentliche Wert m ( (ECC 200 und QR-Code), (Aztec Code) bzw. (PDF417)) entsprechend der Spezifikationen für Datamatrix-, QR-Codes, Aztec Codes und PDF417 zurückgeliefert. Zu erkennen sind Symbole mit ECI-Codes (und damit verdoppelten Backslashs) an den folgenden Werten: ECC 200: 4, 5 und 6, QR-Code: 2, 4 und 6, Aztec Code: 3, 4, 5, 9, 10 und 11, PDF417: 1. Auf den Identifier-Präfix ']d' für Datamatrix bzw. ']Q' für QR-Code bzw. ']z' für Aztec Code bzw. ']L' für PDF417 wird an dieser Stelle verzichtet. Gegebenenfalls muss der Symbology Identifier bestehend aus dem Präfix und Wert m dem eigentlichen Ausgabedatenstrom in der Anwendung manuell vorangestellt werden.
GS1 Symbologien haben die folgenden Identifier: ']d2' für GS1 DataMatrix, ']Q3' für GS1 QR Code und ']z1' für GS1 Aztec Code. Dementsprechend liefert 'symbology_ident' die Werte 2, 3, bzw. 1 zurück.
Datamatrix ECC 200, Aztec Code und QR-Code:
Die dem Durchlauf, in dem der Kandidat gefunden wurde, zugrundeliegende Annahme über die Größe der Lücke zwischen benachbarten Modulen.
Datamatrix ECC 200:
Slant innerhalb des Datamatrix-Symbols im Bogenmaß. Das ist die Differenz zwischen dem Winkel des Finderpatterns und dem rechten Winkel.
Algorithmus, mit dem das Symbol gefunden wurde. Für 'low' wurde das Symbol mit dem Algorithmus gefunden, der nur eine geringe Toleranz gegenüber einem gestörten oder teilweise fehlenden Finderpattern aufweist. Für 'high' wurde das Symbol mit dem Algorithmus gefunden, der diesbezüglich eine hohe Toleranz aufweist. Zu Beachten ist, dass es bei der Verwendung beider Algorithmen vorkommen kann, dass auch Symbole mit ungestörtem Finderpattern vom Algorithmus mit hoher Toleranz gefunden werden.
Dieser Parameter gibt Auskunft darüber, welcher Algorithmus zur Korrektur lokaler Kontrastvariationen verwendet wurde. Für 'high' wurde das Symbol mit einem Algorithmus gefunden, der auch starke lokale Kontrastvariationen korrigieren kann. Für 'low' wurde das Symbol mit dem schnelleren Algorithmus gefunden, der allerdings etwas weniger robust im Fall lokaler Kontrastvariationen ist.
Konnte das Symbol gelesen werden, gibt dieser Parameter Auskunft darüber, ob bei der Bestimmung der Modulpositionen ein variables Gitter verwendet wurde ('variable') oder nicht ('fixed'). Anderenfalls wird entweder die beim letzten Dekodierversuch verwendete Methode oder, falls der Kandidat bereits vor dem Dekodieren verworfen wurde, die Vorgabe aus dem Modell zurückgeliefert.
QR-Code:
Die mit der Symbolgröße korrespondierende Versionsnummer (Version 1 = 21 x 21, Version 2 = 25 x 25, ..., Version 40 = 177 x 177).
Ermittelte Symbolgröße in Modulen.
Typ des QR-Code-Modells. Unterstützt werden das ältere QR-Code-Modell 1 und das neue Modell 2.
Für Kandidaten, die als QR-Code identifiziert werden konnten, wird als erstes versucht, die im Symbol kodierten Formatinformationen zu lesen. Diese enthalten den Code des Maskierungsmusters, das über die eigentlichen Symboldaten gelegt wurde (0 'mask_pattern_ref' 7) sowie den Grad der Fehlerkorrektur, der bei der Kodierung verwendet wurde ('error_correction_level' ['L', 'M', 'Q', 'H']).
PDF417:
Seitenverhältnis der Module; dies entspricht dem Verhältnis von 'module_height' zu 'module_width'.
Für Kandidaten, die als PDF417 identifiziert werden konnten, wird als erstes versucht, die im Symbol kodierten Formatinformationen in den Row-Indicators zu lesen. Diese enthalten auch den Grad der Fehlerkorrektur, der bei der Kodierung verwendet wurde ('error_correction_level' [0, 8]).
Aztec Codes:
Format des dekodierten Symbols: 'compact', 'full_range' oder 'rune'.
Größe des Symbols in Modulen.
In der Mode Message kodierte Anzahl der Layer.
In der Mode Message kodierte Anzahl Codewörter.
Ergebnisse, die sich auf einen konkreten Kandidaten beziehen - Tupelwert Ergebnisse:
Ergebnisse, die sich aus mehreren Werten zusammensetzen und daher immer nur einzeln und für genau einen Kandidaten abgefragt werden können. Bei diesen Ergebnissen ist zu beachten, dass für Kandidaten, deren Bearbeitung vorzeitig abgebrochen wurde (vgl. Bearbeitungsstatus 'status'), nicht alle Ergebnisse sinnvolle Werte liefern:
Alle 2D-Datacode-Modelle:
Binäre Symboldaten, die den einzelnen Modulen zeilenweise entsprechen - ein Wert von 0 bedeutet, dass das entsprechende Modul als Hintergrund interpretiert wurde, bei einem Wert von 100 handelt es sich um ein Vordergrundmodul. Werte zwischen 0 und 100 können sowohl als Vorder- als auch als Hintergrund interpretiert werden. Die Modellpersistenz muss für dieses Ergebnis auf den Wert 1 gesetzt sein (siehe set_data_code_2d_param).
Unkorrigierte Rohdaten, die über ein 2D-Datacode-Typ spezifisches Mapping aus den binären Moduldaten bestimmt werden. Diese Rohdaten sind möglicherweise noch fehlerbehaftet und enthalten auch die Daten, die für die Fehlerkorrektur verwendet werden.
Nach Anwendung der Fehlerkorrektur enthalten die Daten nur noch die korrigierten Nutzdaten ohne die Fehlerkorrekturwörter. Die Daten sind aber immer noch entsprechend des verwendeten 2D-Datacode-Typs kodiert.
Tupel mit den dekodierten Daten im ASCII-Code oder - beim QR-Code und Micro QR-Code - als JIS8 oder Shift JIS Zeichen oder - beim QR-Code - als GB2312 Zeichen. Diese Daten entsprechen der im Symbol kodierten Zeichenkette.
Tupel mit der Bewertung der Druckqualität gemäß dem internationalen Standard ISO/IEC 15415. Das erste Element des Tupels enthält immer die Gesamtqualität des Symbols; Die Länge des Tupels und die Bedeutung der restlichen Elemente hängen vom speziellen Typ des Datacodes ab. Gemäß dem Standard werden die einzelnen Grade mit einem Wert von 0 bis 4 bewertet, wobei 0 für den niedrigsten und 4 für den höchsten Grad steht. Es ist zu beachten, dass, obwohl sich diese Implementierung streng an den Standard hält, die Bewertung der Grade von der Datacode-Dekodierungsprozedur abhängt. Dadurch können die Bewertungsergebnisse leicht von den Ergebnissen anderer Datacode-Leser (von anderen Anbietern) abweichen.
Zur Verwendung dieser Werte ist ein gutes Verständnis der zugrundeliegenden Algorithmen notwendig. Wir empfehlen daher, zusätzlich zu dieser Dokumentation den Standard ISO/IEC 15415:2011 zu lesen.
Für eine exakte Qualitätsberwertung empfehlen wir Bilder zu verwenden, die frei von Störungen wie Defokussierung, Rauschen, Überbelichtung oder inhomogene Beleuchtung sind. Außerdem ist eine effektive Auflösung von mindestens zehn Pixeln in Höhe und Breite pro Modul empfohlen (siehe ISO/IEC 15415, Kapitel 7.3.3).
Für die 2D-Datacodes ECC 200, QR Code, Micro QR Codes und Aztec Code gilt folgende Spezifikation zur Bewertung der Druckqualität, zusammengefasst in einem Tupel mit zwölf Elementen: (overall quality, contrast, modulation, fixed pattern damage, decode, axial nonuniformity, grid nonuniformity, unused error correction, reflectance margin, print growth, contrast uniformity, aperture). Für QR Code und Micro QR Codes wird zusätzlich noch die format information und versions information zurückgegeben.
Die Definitionen einzelner Grade sind wie folgt: Der Grad overall quality ist der Mindestwert aller anderen Grade. Der Grad contrast ist die Differenz zwischen maximalem und minimalem Reflexionswert des Grauwertprofils. Stärkerer Kontrast ergibt einen besseren Grad. Die modulation bewertet die Amplitude zwischen den Datacodemodulen. Höhere Amplituden bedingen, dass dunkle von hellen Modulen zuverlässiger voneinander unterschieden werden können, und dass dieser Grad höher bewertet wird. Es ist noch zu beachten, dass die Bewertung von modulation von der Fehlerkorrekturkapazität (error correction capacity) des Symbols abhängt. Das bedeutet, dass modulation bei Symbolen mit höherer Fehlerkorrekturkapazität langsamer abnimmt. Die contrast uniformity ist der geringste Zahlenwert für die Modulation im gesamten Code. Dieser Wert ist kein Grad, und kann daher reelle Werte annehmen. Er beeinflusst die Berechnung der overall quality nicht. Die reflectance margin bewertet, wie auch die modulation, die Amplitude zwischen den Datacodemodulen. Im Gegensatz zur modulation berücksichtigt die reflectance margin, ob ein Modul richtig klassifiziert werden konnte. Wie die contrast uniformity wird auch die print growth nach ISO/IEC 15415 nicht zu den Graden dazugezählt und geht daher auch nicht in die Berechnung der overall quality ein. Stattdessen wird sie als zusätzliche Information ausgegeben, um einen Aufschluss darüber zu geben, ob die grafischen Strukturen aus denen der 2D-Datacode besteht nicht von ihrer nominellen Größe abweichen. Das bedeutet, dass durch die print growth getestet wird, in welchem Maße die dunklen und hellen Module ihre Modulgrenzen ausfüllen. Die Berechnung der print growth folgt dabei nicht den, im Standard ISO/IEC 15415, spezifizierten Schema, sondern den ISO/IEC Standards des jeweiligen Barcodetyps. Das bedeutet, dass die Berechnung der print growth für Aztec Codes nach den Spezifikationen im ISO/IEC 24778:2008 durchgeführt wird. Für ECC 200 gilt ANSI/AIM International Specification Data Matrix und für QR Codes sowie Micro QR Codes ISO/IEC 18004:2006. Für alle oben beschriebenen 2D-Datacodes wird die print growth in horizontale und vertikale Richtung berechnet. Der ausgegebene Grad entspricht dabei dem kleineren der beiden Grade.
Das Rahmenmuster bei ECC 200, QR Codes und Aztec Codes ist extrem wichtig für das Detektieren eines Symbols. Verschlechterung oder Störung des Rahmenmusters und der benachbarten Ruhezonen wird durch den Grad fixed pattern damage bewertet, welches auf deren Modulationswerten basierend. Der Grad decode besagt, ob der Code dekodiert werden konnte. Der Code muss bereits von find_data_code_2d dekodiert worden sein, damit seine Qualität bewerten werden kann. Deswegen wird der Grad decode automatisch auf 4 gesetzt. Für Symbole, die nicht gefunden und/oder dekodiert werden können, kann auch die Druckqualität nicht bewertet werden. Normalerweise haben Datacodesymbole quadratische Module, d.h. Höhe und Breite eines Moduls sind gleich. Ihr Verhältnis kann durch eine schräge Kameraansicht oder fehlerhaftes Erzeugen des Symbols auch ungleich werden. Diese Abweichung wird durch den Grad axial nonuniformity bewertet. Wenn das Symbol neben einer affinen auch einer perspektivischer Deformation unterliegt, wird das entsprechend im Grad grid nonuniformity bewertet. Da Datacodes über eine gewisse Redundanz verfügen, können Fehler in Modulen oder Codewörtern korrigiert werden. Die ungenutzte Fehlerkorrekturkapazität des untersuchten Symbols wird im Grad unused error correction berechnet. In gewisser Hinsicht bezeichnet dieser Grad die Robustheit des Dekodierungsprozesses. Es ist zu beachten, dass manche Codes mit Grad unused error correction von 0 trotzdem von find_data_code_2d dekodiert werden können. Das liegt daran, dass find_data_code_2d einen robusteren Dekodierungsalgorithmus implementiert als den Referenzdekodierungsalgorithmus, den der Standard vorschlägt.
Für QR Codes und Micro QR Codes werden zusätzlich noch die Module der format information und version information ähnlich wie bei fixed pattern damage bewertet. Falls der Code keine version information enthählt, wird 'N/A' zurückgegeben.
Für den 2D-Stapelcode PDF417 gilt folgende Spezifikation zur Bewertung der Druckqualität zusammengefasst in einem Tupel mit acht Elementen: (overall quality, start/stop pattern, codeword yield, unused error correction, modulation, decodability, defects, aperture).
Die Definitionen einzelner Grade sind wie folgt: Der Grade overall quality ist der Mindestwert aller anderen Grade. Der PDF417 Datacode ist ein Stapelcode, der von laserbasierten Lesegeräten gelesen werden kann. Dementsprechend basiert das Verfahren für Druckqualitätsbewertung auf dem Verfahren für lineare Barcodes: Eine Reihe von Scanlinien wird über das Symbol gleichmäßig verteilt. Dann wird die Reflektionsqualität einzelner Scanlinien bewertet und zum Schluss in die obigen Grade aufsummiert. Mehr Informationen über die Reflektionsgrade sind im Standard ISO/IEC 15416 zu finden. Der Grad start/stop pattern bezieht sich auf die Start- und Stopmuster; der Grad bewertet ihre Reflektionseigenschaften und ob die Sequenzen von Strichen und Lücken korrekt sind. Der Grad codeword yield berechnet den relativen Anteil der richtig dekodierten Codewörter, die unter den Scans liegen. Die ungenutzte Fehlerkorrekturkapazität des behandelten Symbols wird im Grad unused error correction berechnet. Ähnlich wie bei den Matrixdatacodes bezeichnet der Grad modulation die Amplitude zwischen den Symbolmodulen. Der Grad decodability misst die Abweichung der Modulbreiten von ihren im Symbologiestandard vorgegebenen Werten. Zum Schluss bezeichnet der Grad defects Unregelmäßigkeiten im Scanprofil innerhalb einzelner Symbolmodule, deren Vorhandensein mit niedrigerem Grad berechnet wird.
Die aperture gibt die Größe der synthetischen Apertur relativ zur Modulgröße des Symbols an. Diese Apertur wird verwendet, um das Referenz-Grauwert-Bild für die Qualitätsbewertung zu erzeugen. Sie ist definiert in ISO/IEC 15415, Kapitel 7.3.3.
Für die Berechnung der Qualitätsmerkmale ist Voraussetzung, dass der Parameter 'persistence' (siehe set_data_code_2d_param) auf einen Wert größer gleich 0 gesetzt ist.
Tupel aus Rohmesswerten für alle Grade, die 'direkt messbar' sind. Das sind jene Grade, deren Definition im Standard ISO/IEC 15415 einer 'direkten Ableitung' der Geometrie- oder Reflektionseigenschaften des abgebildeten Symbols entsprechen, oder Grade, welche das Ergebnis eines 'direkten Zählens' sind.
Die Elemente des Tupels werden in derselben Reihenfolge zurückgegeben wie die Elemente einer entsprechenden 'quality_isoiec15415'-Abfrage. Für alle Grade, welche von dieser Liste ausgeschlossen sind, liefert die 'quality_isoiec15415_values'-Abfrage den Wert 'N/A' zurück. Für die 2D Datacodes ECC 200, QR Code und Aztec Code sind die Grade overall quality, modulation, fixed pattern damage, decode und reflectance margin ausgeschlossen. Für den 2D Stapelcode PDF417 sind die Grade overall quality, start/stop pattern, modulation, decodability, defects ausgeschlossen.
Obwohl die Grade modulation (für ECC 200 und QR Code) und modulation, decodability, defects (für PDF417) grundsätzlich die Reflektionseigenschaften des Symbols bewerten, werden sie in den nach dem Standard vorgeschriebenen Berechnungen durch ein komplexes Schema berechnet, welches die Dekodierungsroutine und den Fehlerkorrekturmechanismus der Symbologie einbezieht. Zur Folge haben diese Grade keine direkten darunterliegenden Rohmesswerte, die berichtet werden können.
Alle Werte bis auf die print growth sind zwischen 0.0 und 1.0 normalisiert. Somit entspricht z.B. ein Wert von 0.75 für den Grad contrast einem Grauwert von 191.25 (für BYTE Bilder). Für die print growth können Werte zwischen ca. -0.9 und ca. 0.9 erreicht werden. Ein negativer Wert entspricht dabei einer print shrinkage, während bei positiven Werten eine print growth vorliegt. Der ausgegebene Wert beschreibt den prozentualen Anteil um welchen ein dunkles Module zu wenig (print shrinkage) bzw. zu viel (print growth) von seiner nominellen Modulgröße einnimmt. Ein Wert von -0.50 bedeutet beispielsweise, dass ein dunkles Modul 50% kleiner als die nominelle Modulgröße ist. Falls die print growth nicht berechnet werden konnte, wird der Wert auf 'N/A' gesetzt.
Für die Berechnung der Qualitätsmerkmale ist Voraussetzung, dass der Parameter 'persistence' (siehe set_data_code_2d_param) auf einen Wert größer gleich 0 gesetzt ist.
Data Matrix ECC 200:
Tupel mit Zwischenergebnissen der Qualitätsbewertung von ECC 200 Codes nach den internationalen Standards ISO/IEC 15415:2011 und ISO/IEC 16022:2006. Zur Verwendung dieser Werte ist ein gutes Verständnis der zugrundeliegenden Algorithmen notwendig. Wir empfehlen daher dringend, zusätzlich zu dieser Dokumentation die Standards ISO/IEC 15415:2011 und ISO/IEC 16022:2006 zu lesen.
Die Bedeutung der einzelnen Grade und Werte werden im folgenden beschrieben. Sie entsprechen jeweils dem minimalen Grad und Wert des inspizierten Codes.
'Rmin' und 'Rmax': Minimum und Maximum der Grauwerte in der Bewertungsregion des Symbols (siehe Kapitel 7.6, ISO/IEC 15415:2011). Zu diesem Wert gibt es keinen entsprechenden Grad.
'L1' und 'L2': Grade der vertikalen und horizontalen Teile des äußeren L des Rahmenmusters (siehe Kapitel M.1.2, ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'QZL1' und 'QZL2': Grade der vertikalen und horizontalen Teile der L1 und L2 benachbarten Ruhezonen (siehe Kapitel M.1.2, ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'Transition Ratio': Grad für den „transition ratio test“ (Übergangsraten-Test) der in Kapitel M.1.3 b), ISO/IEC 16022:2006, beschrieben ist. Die Übergangsrate TR wird als Werte zurückgegeben. Sie gibt das Verhältnis zwischen der Anzahl von Übergängen auf dem „clock track“ (alternierendes Muster) und der Anzahl von Übergängen in der „solid area“ (Ruhezone oder Teil eines L) an.
'Clock track regularity': Grad für die Regelmäßigkeit des alternierenden Musters („clock track regularity test“). Dieser Test ist in Kapitel M.1.3 e), ISO/IEC 16022:2006 beschrieben. Wenn irgendeine Folge von fünf benachbarten Punkten mehr als zwei Modul-Fehler enthält, ist dieser Grad 0, sonst ist er 4. Für diesen Grad gibt es keinen entsprechenden Wert.
'Clock track damage': Grad für die Beschädigung des alternierenden Musters („clock track damage“) (siehe Kapitel M.1.3 f), ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'Solid fix pattern': Grad für die Beschädigung des zum alternierenden Muster gehörenden Teil der Ruhezone oder eines L („solid fixed pattern“) (siehe Kapitel M.1.3 f), ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'Clock track and adjacent solid pattern': Grad für das gesamte alternierende Muster inklusive der dazugehörenden Ruhezonen, sowie der inneren L Muster (siehe Kapitel M.1.3 k), ISO/IEC 16022:2006). Für diesen Grad gibt es keinen entsprechenden Wert.
'Average grade': Durchschnittlicher Grad für das gesamte Rahmenmuster. Dieser Grad basiert auf den Ergebnissen der Bewertungen für L1, L2, QZL1, QZL2, und dem Ergebnis für 'Clock track and adjacent solid pattern' (siehe Kapitel M.1.4, ISO/IEC 16022:2006). Für diesen Grad gibt es keinen entsprechenden Wert.
Der Grad für fixed pattern damage für das Symbol ist das Minimum der Grade für 'L1', 'L2', 'QZL1', 'QZL2', 'Clock track and adjacent solid pattern' und 'Average grade'.
Tupel mit der Bewertung der Druckqualität gemäß dem internationalen Standard SEMI T10-0701.
Das zurückgegebene Wertetupel umfasst die folgenden 21 Werte: [P1 Row, P1 Column, P2 Row, P2 Column, P3 Row, P3 Column, P4 Row, P4 Column, Rows, Columns, Symbol Contrast, Symbol Contrast SNR, Horizontal Mark Growth, Vertical Mark Growth, Data Matrix Cell Width, Data Matrix Cell Height, Horizontal Mark Misplacement, Vertical Mark Misplacement, Cell Defects, Finder Pattern Defects, Unused Error Correction]. Die Unused Error Correction wird für jeden Reed-Solomon Block einzeln zurück gegeben. Die tatsächliche Tupellänge hängt somit von der Anzahl der Reed-Solomon Blöcke ab.
Die Definitionen einzelner Werte sind wie folgt: Die ersten acht Einträge enthalten die Koordinaten der vier Eckpunkte des Codes. Diese sind dem Standard entsprechend gegen den Uhrzeigersinn (bei nicht gespiegeltem Code), beginnend beim vertikalen Finderpattern, angeordnet. Rows und Columns geben die Zeilen- und Spaltenanzahl des Codes an.
Der Wert Symbol Contrast gibt den prozentualen Kontrast zwischen den als hell bzw. dunkel klassifizierten Pixeln an. Symbol Contrast SNR ist das entsprechende Signal-Rausch-Verhältnis. Sollte der Signal-Rausch-Verhältnis einen unendlichen Wert haben, wird 'N/A' zurückgegeben.
Die Werte für Horizontal Mark Growth und Vertical Mark Growth stellen die prozentuale Breite bzw. Höhe der markierten Module im Verhältnis zur Summe der Breite bzw. Höhe eines markierten Moduls und eines Zwischenraums dar. Ein Wert von 50% ist optimal. Falls Teile des alternierenden Patterns verdeckt sind, wird 'N/A' zurückgegeben.
Die Werte für Data Matrix Cell Width und Data Matrix Cell Height werden aus den vier Eckpunkten und der Anzahl von Spalten bzw. Zeilen des Codes berechnet und geben die durchschnittlichen Modulebreiten bzw. -höhen an.
Die Werte für Horizontal Mark Misplacement und Vertical Mark Misplacement geben die Abweichungen der Markierungen des alternierenden Patterns von idealen Mittelpunkten in horizontaler und vertikaler Richtung an. Die Werte werden prozentual im Verhältnis zu Data Matrix Cell Width und Data Matrix Cell Height angegeben. Falls Teile des alternierenden Patterns verdeckt sind, wird 'N/A' zurückgegeben.
Der Wert für Cell Defects gibt den Prozentsatz der Modulpixel an, die falsch klassifiziert wurden.
Der Wert für Finder Pattern Defects gibt den Prozentsatz der Findern pattern Pixel an, die nicht als Markierungen klassifiziert werden würden.
Der Wert für Unused Error Correction gibt die ungenutzte Fehlerkorrekturkapazität der einzelnen Reed-Solomon Blöcke an.
Für die Berechnung der Qualitätsmerkmale ist Voraussetzung, dass der Parameter 'persistence' (siehe set_data_code_2d_param) auf einen Wert größer gleich 0 gesetzt ist.
Gibt die Namen der Elemente des Qualitätstupels, das von get_data_code_2d_results mit Parameter 'quality_semi_t10_values' ausgegeben wird, zurück. Besitzt der ECC 200 Code mehr als ein Reed-Solomon Block, wird der Namenstupel um diese Werte erweitert.
Data Matrix ECC 200, Aztec, QR Code and Micro QR Code:
Tupel mit der Bewertung der Druckqualität gemäß dem internationalen Standard AIM DPM-1-2006. AIM DPM-1-2006 ist eine Erweiterung des Standards ISO/IEC 15415, indem er bestimmte Vorgaben für die Grauwerteigenschaften des Datacodebildes setzt und dadurch die Vergleichbarkeit der Qualitätsbewertungen unterschiedlicher Datacodeverifikatoren (von unterschiedlichen Anbietern) erhöht.
Zur Verwendung dieser Werte ist ein gutes Verständnis der zugrundeliegenden Algorithmen notwendig. Wir empfehlen daher, zusätzlich zu dieser Dokumentation die Standards AIM DPM-1-2006 und ISO/IEC 15415:2011 zu lesen.
Es ist sehr wichtig zu wissen, dass eine AIM DPM-1-2006 konforme Druckqualitätsbewertung nur mithilfe eines interaktiven Bildeinzugs durchgeführt wird! Bilder von Datacode Symbolen dürfen nicht berücksichtigt werden, wenn keine Informationen über die Konfiguration der Kamera-Beleuchtung zur Verfügung stehen (siehe den Standard AIM DPM-1-2006 für einige vorgeschriebene Kamerabeleuchtungskonfigurationen und allgemeine Konfigurationprinzipien, die für den Standard von Bedeutung sind). Wir weisen darauf hin, dass, obwohl sich diese Implementierung streng an den Standard hält, die Bewertung der Grade von der Datacode Dekodierungsprozedur abhängt. Deswegen ist eine mithilfe dieses Operators erworbene Qualitätsbewertung nur für HALCON's Datacodeleser maßgeblich.
Beim Ausführen von get_data_code_2d_results mit Parameter 'quality_aimdpm_1_2006' wird angenommen, dass das behandelte Bild die beiden unten beschriebenen Kriterien erfüllt. Die zurückgegebene Druckqualitätsbewertung umfasst die folgenden 13 Grade: (overall quality, cell contrast, cell modulation, fixed pattern damage, decode, axial nonuniformity, grid nonuniformity, unused error correction, mean light, reflectance margin, print growth, contrast uniformity, aperture). Die ersten acht, sowie die letzten drei Grade haben dieselbe Bedeutung wie im ISO/IEC 15415 Standard. Es gibt nur zwei Ausnahmen: contrast und modulation wurden zu cell contrast bzw. cell modulation umbenannt, um auf die Unterschiede zwischen den entsprechenden Formeln beider Standards hinzuweisen. Der Wert mean light ist im AIM DPM-1-2006 nicht als Grad definiert. Er ist eine Bewertung der Qualität des behandelten Bildes und wird als Mittelgrauwert der Zentren der hellen Datacodesymbolmodulen definiert. mean light kann einen Wert im Bereich 0.0 bis 1.0 haben, was 0% bis bzw. 100% des maximalen Grauwerts (255 bei Byte Bildern) entspricht.
Der Standard ist im wesentlichen die Definition einer Prozedur für die Einstellung der Kameraparameter (der so genannte camera system response - SR): Belichtungszeit, Gain, und/oder andere Einstellungen, die spezifisch für den Kamerabeleuchtungaufbau des Benutzers sind. Das Ziel ist es, ein Bild des 2D Datacodesymbols einzuziehen, das optimale Grauwerteigenschaften hat. In Bildverarbeitungskontext, welcher im Mittelpunkt des Standards steht, ist das die Voraussetzung für die erhöhte Vergleichbarkeit der Bewertungsergebnisse unterschiedlicher Verifikatoren. Laut Standard hat ein Bild optimale Grauwerteigenschaften, wenn sein mean light zwischen 70% und 86% liegt (bzw. 0.70 und 0.86). Um diese Bedingung für Bilder eines Datacodesymbols mit niedrigem materiellen Kontrast zu erfüllen, kann es häufig zu sehr hohen SR-Werten führen. Deswegen definiert der Standard eine zusätzliche (Kalibrierungs-)Prozedur, deren Aufgabe es ist, den normalen (so-genannten kalibrierten) system response (SRcal) für Vergleichszwecke zu berechnen. Das wird gemacht, indem die Bilder eines Objektes mit bekannten Reflexionseigenschaften (z.B. NIST tracable calibrated conformance test card) bewertet werden. Letztendlich die zwei Bildeinzugkriterien sind wie folgt formuliert: Zum einen, muss das Bewertungsbild einen mean light Wert im Bereich von 70% bis 86% (0.70 und bzw. 0.86) haben; zum anderen, muss das Bild mit Kameraeinstellungen (SR) eingezogen worden sein, welche die Bedingung SR/SRcal16 erfüllen. Falls kein Bild eines Datacodes, das diese Kriterien erfüllt, eingezogen werden kann, wird der Datacode mit Grad 0 bewertet.
Da weder die Einstellung der Kameraparameter (SR) noch die Überprüfung des SR-Kriteriums innerhalb eines HALCON Operators durchgeführt werden kann, ist eine AIM DPM-1-2006 konforme Druckqualitätsbewertung nur in einem geeigneten Programmaufbau möglich. Der Benutzer sei auf zwei mitgelieferte Beispielprogramme verwiesen (calibration_aimdpm_1_2006.hdev und print_quality_aimdpm_1_2006.hdev im Verzeichnis HALCONEXAMPLES/hdevelop/Identification/Data-Code). Dort sind beide Bildeinzugskriterien näher erklärt und demonstriert. Jeder, der den AIM DPM-1-2006 Standard für den eigenen Kamerabeleuchtungaufbau anpassen will, kann diese Programme als Startpunkt verwenden.
Die aperture gibt die Größe der synthetischen Apertur relativ zur Modulgröße des Symbols an. Diese Apertur wird verwendet um das Referenz-Grauwert-Bild für die Qualitätsbewertung zu erzeugen. Sie wird nach dem in AIM DPM-1-2006, Kapitel 7.3 beschriebenen Verfahren festgelegt.
Für die Berechnung der Qualitätsmerkmale ist Voraussetzung, dass der Parameter 'persistence' (siehe set_data_code_2d_param) auf einen Wert größer gleich 0 gesetzt ist.
Ähnlich wie 'quality_isoiec15415_values' gibt diese Abfrage einen Tupel aus Rohmesswerten für alle Grade, die 'direkt messbar' sind zurück. Die Werte werden allerdings nach dem Standard AIM DPM-1-2006 berechnet. Die Liste der zurückgegebenen sowie der ausgeschlossenen Werte ist dieselbe wie für die 'quality_isoiec15415_values'-Abfrage. Der AIM DPM-1-2006-spezifische Hilfsgrad mean light wird von beiden Abfragen ('quality_aimdpm_1_2006' und 'quality_aimdpm_1_2006_values') in demselben Formatzurückgegeben.
Für die Berechnung der Qualitätsmerkmale ist Voraussetzung, dass der Parameter 'persistence' (siehe set_data_code_2d_param) auf einen Wert größer gleich 0 gesetzt ist.
Data Matrix ECC 200:
Tupel mit Zwischenergebnissen der Qualitätsberwertung von ECC 200 Codes nach den internationalen Standards AIM DPM-1-2006, ISO/IEC 15415:2011 und ISO/IEC 16022:2006. Zur Verwendung dieser Werte ist ein gutes Verständnis der zugrundeliegenden Algorithmen notwendig. Wir empfehlen daher dringend zusätzlich zu dieser Dokumentation die Standards AIM DPM-1-2006, ISO/IEC 15415:2011 und ISO/IEC 16022:2006 zu lesen.
Die Bedeutung der einzelnen Grade und Werte werden im folgenden beschrieben. Sie entsprechen jeweils dem minimalen Grad und Wert des inspizierten Codes.
'T2': Schwellwert aus dem Histogram der Grauwerte des Referenz-Grauwert-Bildes (siehe Anhang A, AIM DPM-1-2006).
'MD': Der zu T2 gehörende Wert von MeanDark (siehe Anhang A, AIM DPM-1-2006).
'MLtarget': Der zu T2 gehörende Wert von MeanLight (siehe Anhang A, AIM DPM-1-2006).
'L1' und 'L2': Grade der vertikalen und horizontalen Teile des äußeren L des Rahmenmusters (siehe Kapitel M.1.2, ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'QZL1' und 'QZL2': Grade der vertikalen und horizontalen Teile der L1 und L2 benachbarten Ruhezonen (siehe Kapitel M.1.2, ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'Transition Ratio': Grad für den „transition ratio test“ (Übergangsraten-Test) der in Kapitel M.1.3 b), ISO/IEC 16022:2006, beschrieben ist. Die Übergangsrate TR wird als Werte zurückgegeben. Sie gibt das Verhältnis zwischen der Anzahl von Übergängen auf dem „clock track“ (alternierendes Muster) und der Anzahl von Übergängen in der „solid area“ (Ruhezone oder Teil eines L) an.
'Clock track regularity': Grad für die Regelmäßigkeit des alternierenden Musters („clock track regularity test“). Dieser Test ist in Kapitel M.1.3 e), ISO/IEC 16022:2006 beschrieben. Wenn irgendeine Folge von fünf benachbarten Punkten mehr als zwei Modul-Fehler enthält, ist dieser Grad 0, sonst ist er 4. Für diesen Grad gibt es keinen entsprechenden Wert.
'Clock track damage': Grad für die Beschädigung des alternierenden Musters („clock track damage“) (siehe Kapitel M.1.3 f), ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'Solid fix pattern': Grad für die Beschädigung des zum alternierenden Muster gehörenden Teil der Ruhezone oder eines L („solid fixed pattern“) (siehe Kapitel M.1.3 f), ISO/IEC 16022:2006). Die entsprechende Anzahl an fehlerhaften Modulen wird als Wert zurückgegeben.
'Clock track and adjacent solid pattern': Grad für das gesamte alternierende Muster inklusive der dazugehörenden Ruhezonen, sowie der inneren L Muster (siehe Kapitel M.1.3 k), ISO/IEC 16022:2006). Für diesen Grad gibt es keinen entsprechenden Wert.
'Average grade': Durchschnittlicher Grad für das gesamte Rahmenmuster. Dieser Grad basiert auf den Ergebnissen der Bewertungen für L1, L2, QZL1, QZL2, und dem Ergebnis für 'Clock track and adjacent solid pattern' (siehe Kapitel M.1.4, ISO/IEC 16022:2006). Für diesen Grad gibt es keinen entsprechenden Wert.
'Distributed damage grade': Durchschnittlicher Grad für das gesamte Rahmenmuster. Dieser Grad basiert auf den Ergebnissen der Bewertungen für L1, L2, QZL1, QZL2, und dem Ergebnis für 'Clock track and adjacent solid pattern' (siehe Kapitel M.1.4, ISO/IEC 16022:2006, sowie Kapitel 9.4, AIM DPM-1-2006). Für diesen Grad gibt es keinen entsprechenden Wert.
Der Grad für fixed pattern damage für das Symbol ist das Minimum der Grade für 'L1', 'L2', 'QZL1', 'QZL2', 'Clock track and adjacent solid pattern' und 'Distributed damage grade'.
Data Matrix ECC 200, QR Code, and Aztec Code:
Ist das Symbol Bestandteil einer Gruppe von zusammengehörigen Symbolen („Structured Append“), enthält das Ergebnistupel (1.) den Index des Symbols in der Gruppe, (2.) die Anzahl zusammengehöriger Symbole sowie (3.) eine Zahl als Gruppenidentifikator.
Data Matrix ECC 200:
Enthält das Symbol ein Reader Programming Zeichen (welches signalisiert, dass dieses Symbol eine Nachricht enthält um das Lesesystem zu programmieren) gib dieser Parameter 'yes' zurück. Andernfalls gibt dieser Parameter 'no' zurück. Das Reader Programming Zeichen ist nicht Bestandteil der dekodierten Nachricht.
PDF417:
Symbole, die Bestandteil einer Gruppe von zusammengehörigen Symbolen sind, werden als „Macro PDF417“ Symbole bezeichnet. Diese Symbole enthalten neben den herkömmlichen Daten einen Control Block, in dem weitere Informationen gespeichert sind. Für Macro-Symbole liefert 'macro_exist' den Wert 1, für herkömmliche Symbole den Wert 0 zurück.
Liefert den Index des Symbols in der Gruppe. Diese Information ist für Macro-Symbole obligatorisch.
Liefert den Gruppenidentifikator in Form eines Strings. Diese Information ist für Macro-Symbole obligatorisch.
Liefert die Anzahl zusammengehöriger Symbole. Diese Information ist für Macro-Symbole optional.
Liefert den Zeitstempel der Quelldatei als Anzahl der seit 1970:01:01:00:00:00 GMT vergangener Sekunden in Form eines Strings. Diese Information ist für Macro-Symbole optional.
Liefert die CRC-Checksumme für die gesamte Quelldatei unter Verwendung des CCITT-16 Polynoms. Diese Information ist für Macro-Symbole optional.
Liefert 1, falls das Symbol das letzte innerhalb der Gruppe zusammengehöriger Sybole ist, ansonsten 0. Diese Information ist für Macro-Symbole optional.
Statusinformation
Anhand der Statusinformation, die für jeden Kandidaten abgefragt werden kann, lässt sich leicht nachvollziehen, an welcher Stelle ein Kandidat verworfen wurde. Die folgende Übersicht enthält die wichtigsten Statusmeldungen in der Reihenfolge, in der sie bei der Bearbeitung auftreten können:
Datamatrix ECC 200:
Symbol ist zu nahe am Bildrand. Damit das Symbol gelesen werden kann, muss es vollständig im Bild liegen.
Es ist nicht möglich, die genaue Position des Finderpatterns in der Verarbeitungsebene zu bestimmen, da kein signifikanter Hell-Dunkel-Übergang gefunden werden kann.
Für eine der beiden Seiten des Finderpatterns kann dessen Breite nicht ermittelt werden, da keine signifikanten Hell-Dunkel-Übergänge gefunden werden können.
Die für die beiden Seiten des Finderpatterns ermittelten Breiten unterscheiden sich zu sehr.
Bei der Symbolsuche wurden (in einer Richtung) zwar die beiden gegenüberliegenden Seiten des Symbols gefunden, es kann aber nicht bestimmt werden, welches die alternierende Seite des Finderpatterns ist.
Bei der Symbolsuche wurde (in einer Richtung) nur die durchgehende Seite des Finderpatterns gefunden. Bei der weiteren Verarbeitung war es jedoch nicht möglich, die gegenüberliegende (alternierende) Seite zu finden.
Die aus den beiden alternierenden Seiten bestimmte Anzahl von Symbolzeilen und -spalten ergibt keinen gültigen ECC 200-Code.
Die ermittelte Symbolgröße ist zwar gültig, liegt jedoch nicht in dem vom Modell vorgegebene Bereich.
Anhand der Symbolgröße wurde ein rechteckiger ECC 200-Code ermittelt. Auf Grund der im Modell angegebenen Restriktion hinsichtlich der Spiegelung des Symbols sind jedoch Zeilen und Spalten vertauscht, so dass das Symbol keinen gültigen ECC 200-Code enthält. Bei quadratischen Symbolen kann dieser Test natürlich nicht erfolgen, so dass sich hier eine falsche Angabe zur Spiegelung erst beim Lesen auswirkt und i.d.R. zum folgenden Fehler führt:
Die Fehlerkorrektur scheitert an zu vielen falsch interpretierten Modulen. Das deutet i.d.R. auf eine zu schlechte Bild- und/oder Druckqualität hin, kann aber auch an einer falschen Vorgabe hinsichtlich der Spiegelung des Symbols liegen.
Diese Fehlermeldung zeigt an, dass die kodierten Daten eine Nachricht zum Programmieren der Leseeinheit enthalten. Dies wird nicht unterstützt.
Die im Symbol kodierten Daten können nicht dekodiert werden, da sie nicht konsistent sind.
Die Daten im Symbol entsprechen nicht den allgemeinen GS1 Spezifikationen. Diese Fehlermeldung wird zurückgegeben, wenn versucht wird, ein gültiges Nicht-GS1-Symbol mit einem als GS1-Datacode erstellten Modell zu lesen.
Die Ruhezone dieses Kandidaten fehlt oder weist starke Defekte auf.
Datamatrix ECC 200 (falls eine hohe Finderpattern-Toleranz gewählt wurde, können zusätzlich folgende Meldungen auftreten):
Es konnte keine regelmäßige Gitterstruktur innerhalb der Kandidatenregion gefunden werden. Daher wird davon ausgegangen, dass es sich bei dem Kandidaten nicht um ein ECC 200 Symbol handelt.
Der aktuelle Kandidat überlappt mit einem zuvor erfolgreich dekodierten Symbol. Daher wird die Suche nach der Symbolgrenze im Bild abgebrochen.
Es wurde keine konsistente Symbolgrenze innerhalb der vorgegebenen Grenzen gefunden, die zu einem erfolgreich dekodierten Symbol geführt hätte.
Der Kandidat konnte zwar dekodiert werden, da die Symbolgröße allerdings sehr klein und die Anzahl der Dekodierungsfehler relativ hoch war, handelt es sich höchstwahrscheinlich nicht um einen ECC 200. Daher wurde der Kandidat verworfen. Diese Heuristik gilt für Symbole der Größe 10 x 10 mit mindestens 1 Dekodierungsfehler und für Symbole der Größe 12 x 12 oder 8 x 18 mit mindestens 2 Dekodierungsfehlern.
QR-Code:
Symbol ist zu nahe am Bildrand. Damit das Symbol gelesen werden kann, muss es vollständig im Bild liegen.
Es ist nicht möglich, anhand der Position-Detection-Patterns die genaue Position des Finderpatterns in der Verarbeitungsebene zu bestimmen, da kein signifikanter Hell-Dunkel-Übergang gefunden werden kann.
Es konnte mit Hilfe des Finderpatterns keine einheitliche Symbolgröße ermittelt werden. Beim Modelltyp 2 führt das nur bei kleinen Symbolen (< Version 7 bzw. 45 x 45 Modulen) zu einem Fehler, da bei größeren Symbolen die Versionsinformation im Symbol kodiert und von dort gelesen wird.
Die anhand des Finderpatterns ermittelte Größe ist zu klein bzw. (nur Modelltyp 1) zu groß.
Beim Versuch, ein Modell-2-Symbol zu lesen, wurde mit Hilfe der Finderpatterns ermittelt, dass die Symbolversion mindestens 7 ist ( 45 x 45 Module). Es ist jedoch nicht möglich, die Versionsdaten aus den entsprechenden Feldern im Symbol zu dekodieren.
Die ermittelte Symbolgröße ist zwar gültig, liegt jedoch nicht in dem vom Modell vorgegebenen Bereich.
Die im Symbol kodierten Formatinformationen (Maskierungsmuster und Grad der Fehlerkorrektur) konnten nicht gelesen werden.
Die Fehlerkorrektur scheitert an zu vielen falsch interpretierten Modulen. Das deutet i.d.R. auf eine zu schlechte Bild- und/oder Druckqualität hin, kann aber auch an einer falschen Vorgabe hinsichtlich der Spiegelung des Symbols liegen.
Die im Symbol kodierten Daten können nicht dekodiert werden, da sie nicht konsistent sind.
Die Daten im Symbol entsprechen nicht den allgemeinen GS1 Spezifikationen. Diese Fehlermeldung wird zurückgegeben, wenn versucht wird, ein gültiges Nicht-GS1-Symbol mit einem als GS1-Datacode erstellten Modell zu lesen.
Aztec Code:
Symbol ist zu nahe am Bildrand oder teilweise außerhalb des Bildes.
Die Mode Message dieses Kandidaten konnte nicht dekodiert werden, da die Fehlerkorrektur an zu vielen falsch interpretierten Modulen gescheitert ist.
Die Expansion des Kandidaten ist fehlgeschlagen. Die Ursache sind meist zu starke perspektivische Verzeichnungen.
Die ermittelte Symbolgröße ist zwar gültig, liegt jedoch nicht in dem vom Modell vorgegebenen Bereich. Das Modell muss angepasst werden (set_data_code_2d_param), damit dieser Kandidat auch dekodiert werden kann.
Dieser Kandidat ist gültig, erfüllt aber nicht die im Modell bezüglich Spiegelung ('format') vorgegebenen Einschränkungen. Das Modell muss angepasst werden (set_data_code_2d_param), damit dieser Kandidat auch dekodiert werden kann.
Dieser Kandidat ist gültig, erfüllt aber nicht die im Modell bezüglich des Formats ('mirrored') vorgegebenen Einschränkungen. Das Modell muss angepasst werden (set_data_code_2d_param), damit dieser Kandidat auch dekodiert werden kann.
Die Fehlerkorrektur scheitert an zu vielen falsch interpretierten Modulen. Das deutet i.d.R. auf eine zu schlechte Bild- und/oder Druckqualität hin, kann aber auch an einer falschen Vorgabe hinsichtlich der Spiegelung des Symbols liegen.
Die Daten im Symbol entsprechen nicht den allgemeinen GS1 Spezifikationen. Diese Fehlermeldung wird zurückgegeben, wenn versucht wird, ein gültiges Nicht-GS1-Symbol mit einem als GS1-Datacode erstellten Modell zu lesen.
PDF417:
Symbol ist zu nahe am Bildrand. Damit das Symbol gelesen werden kann, muss es vollständig im Bild liegen.
Die ermittelte Symbolgröße ist zwar gültig, liegt jedoch nicht in dem vom Modell vorgegebene Bereich.
Die Fehlerkorrektur scheitert an zu vielen falsch interpretierten Modulen. Das deutet i.d.R. auf eine zu schlechte Bild- und/oder Druckqualität hin, kann aber auch an einer falschen Vorgabe hinsichtlich der Spiegelung des Symbols liegen.
Diese Fehlermeldung zeigt an, dass die kodierten Daten eine Nachricht zum Programmieren der Leseeinheit enthalten. Dies wird nicht unterstützt.
Die im Symbol kodierten Daten können nicht dekodiert werden, da sie nicht konsistent sind.
Bei der Bearbeitung eines Kandidaten kann es vorkommen, dass mehrere Versuche unternommen werden, um ein Symbol zu lesen, wobei intern über die verschiedenen Annahmen, die das Modell zulässt, iteriert wird. Dabei bestimmt i.d.R. der letzte Versuch den Abbruchstatus. Erlaubt ein QR-Code-Modell beispielsweise sowohl Modelltyp 1 als auch Typ 2, wird zuerst versucht, das Symbol als Modell 2 zu interpretieren. Scheitert dies, wird von einem Modell-1-Symbol ausgegangen. Ist auch dieser Versuch nicht erfolgreich, enthält die Statusvariable den Fehlercode, mit dem die Interpretation als Modell-1-Symbol abgebrochen wurde. Um den ersten Fehlercode zu erhalten, muss vor dem Aufruf von find_data_code_2d das Modell entsprechend eingeschränkt werden.
Handle des zu verwendenden 2D-Datacode-Modells.
Handle des 2D-Datacode-Kandidaten, dessen Informationen abgefragt werden sollen, oder ein String, der eine Gruppe von Kandidaten beschreibt.
Defaultwert: 'all_candidates'
Wertevorschläge: 0, 1, 2, 'general', 'all_candidates', 'all_results', 'all_undecoded', 'all_aborted'
Namen der Ergebnisse, die für einen oder eine Gruppe von 2D-Datacode-Kandidaten abgefragt werden sollen.
Defaultwert: 'status'
Wertevorschläge: 'min_search_level', 'max_search_level', 'pass_num', 'result_num', 'candidate_num', 'undecoded_num', 'aborted_num', 'handle', 'pass', 'status', 'search_level', 'process_level', 'polarity', 'module_gap', 'mirrored', 'model_type', 'symbol_rows', 'symbol_cols', 'symbol_size', 'version', 'module_height', 'module_width', 'small_modules_robustness', 'module_aspect', 'slant', 'contrast', 'module_grid', 'decoded_string', 'decoding_error', 'symbology_ident', 'mask_pattern_ref', 'finder_pattern_tolerance', 'contrast_tolerance', 'error_correction_level', 'bin_module_data', 'raw_coded_data', 'corr_coded_data', 'decoded_data', 'quality_isoiec15415', 'quality_isoiec15415_labels', 'quality_isoiec15415_values', 'quality_aimdpm_1_2006', 'quality_aimdpm_1_2006_labels', 'quality_aimdpm_1_2006_values', 'quality_isoiec15415_intermediate', 'quality_isoiec15415_intermediate_labels', 'quality_isoiec15415_intermediate_values', 'quality_aimdpm_1_2006_intermediate', 'quality_aimdpm_1_2006_intermediate_labels', 'quality_aimdpm_1_2006_intermediate_values', 'quality_semi_t10_values', 'quality_semi_t10_labels', 'structured_append', 'macro_exist', 'macro_segment_index', 'macro_file_id', 'macro_segment_count', 'macro_time_stamp', 'macro_checksum', 'macro_last_symbol', 'reader_programming', 'timeout_occurred'
Liste mit den Ergebnissen.
* Example demonstrating how to access the results of the data code search.
* Create a model for reading Data matrix ECC 200 codes
create_data_code_2d_model ('Data Matrix ECC 200', [], [], DataCodeHandle)
* Read an image
read_image (Image, 'datacode/ecc200/ecc200_cpu_010')
* Read the symbol in the image
find_data_code_2d (Image, SymbolXLDs, DataCodeHandle, [], [], \
ResultHandles, DecodedDataStrings)
* Get the number of passes
get_data_code_2d_results (DataCodeHandle, 'general', 'pass_num', Passes)
* Get a tuple with the status of all candidates
get_data_code_2d_results (DataCodeHandle, 'all_candidates', 'status', \
AllStatus)
* Get the handles of all candidates that were detected as a symbol but
* could not be read
get_data_code_2d_results (DataCodeHandle, 'all_undecoded', 'handle', \
HandlesUndecoded)
* For every undecoded symbol, get the contour, the symbol size, and
* the binary module data
dev_set_color ('red')
for i := 0 to |HandlesUndecoded| - 1 by 1
* Get the contour of the symbol
get_data_code_2d_objects (SymbolXLD, DataCodeHandle, \
HandlesUndecoded[i], 'candidate_xld')
* Get the symbol size
get_data_code_2d_results (DataCodeHandle, HandlesUndecoded[i], \
['symbol_rows','symbol_cols'], SymbolSize)
* Get the binary module data (has to be queried exclusively)
get_data_code_2d_results (DataCodeHandle, HandlesUndecoded[i], \
'bin_module_data', BinModuleData)
* Stop for inspecting the data
stop ()
endfor
* Clear the model
clear_data_code_2d_model (DataCodeHandle)
get_data_code_2d_results liefert den Wert 2 (H_MSG_TRUE), falls die übergebenen Parameter korrekt und die angeforderten Ergebnisse für die letzte Symbolsuche verfügbar sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.
find_data_code_2d, query_data_code_2d_params
query_data_code_2d_params, get_data_code_2d_objects, get_data_code_2d_param, set_data_code_2d_param
AIM Global Document: AIM DPM-1-2006: „Direct Part Mark (DPM) Quality Guideline“;
Document Type: AIM Bar Code Guideline;
Document Version: 1.0, 2006-12-12.
International Standard ISO/IEC 15415: „Information technology -
Automatic identification and data capture techniques -
Bar code symbol print quality test specification - Two-dimensional symbols“;
Reference number ISO/IEC 15415:2011 (E);
ISO/IEC 2011.
International Standard ISO/IEC 16022: „Information technology -
Automatic identification and data capture techniques -
Data Matrix bar code symbology specification“;
Reference number ISO/IEC 16022:2006 (E);
ISO/IEC 2006.
International Standard ISO/IEC 15438: „Information technology -
Automatic identification and data capture techniques -
PDF417 bar code symbology specification“;
Reference number ISO/IEC 15438:2006 (E);
ISO/IEC 2006.
International Standard ISO/IEC 18004: „Information technology -
Automatic identification and data capture techniques -
QR Code 2005 bar code symbology specification“;
Reference number ISO/IEC 18004:2006 (E);
ISO/IEC 2006.
International Standard ISO/IEC 24778: „Information technology -
Automatic identification and data capture techniques -
Aztec Code bar code symbology specification“;
Reference number ISO/IEC 24778:2008 (E);
ISO/IEC 2008.
GS1 General Specifications; Version 12; Issue 1, Jan-2012; GS1.
Data Code
| Operatoren |