| Operatoren |
get_bar_code_object — Zugriff auf ikonische Objekte, die bei der Suche und der Dekodierung von Barcodes angelegt werden bzw. diese beschreiben.
get_bar_code_object( : BarCodeObjects : BarCodeHandle, CandidateHandle, ObjectName : )
Der Operator get_bar_code_object erlaubt den Zugriff auf ikonische Objekte, die beim letzten Aufruf von find_bar_code während der Suche nach Barcodes oder beim Lesen der gefundenen Symbole angelegt wurden. Für den Zugriff muss neben dem Namen des gewünschten Bildobjekts (ObjectName) auch das zugrundeliegende Barcode-Modell (BarCodeHandle) angegeben werden. Außerdem muss in CandidateHandle ein Index auf ein dekodiertes Symbol oder einen Symbolkandidaten, bzw. 'all' für alle dekodierten Symbole oder Symbolkandidaten übergeben werden.
Je nachdem wie der Parameter ObjectName ausgewählt ist, werden die Ausgabeobjekten in BarCodeObjects zurückgeliefert, wie folgend:
Die Regionen von erfolgreich dekodierten Symbolen werden zurückgegeben. Die Reihenfolge der Objekte entspricht der Reihenfolge der dekodierten Zeichenfolgen im Operator get_bar_code_result.
Die potentiellen Barcode-Regionen werden ausgegeben. Gibt es insgesamt m Kandidaten und n erfolgreiche Ergebnisse, so können mit CandidateHandle gleich 0 bis (n-1) die ursprünglichen Regionen der entsprechenden Ergebnisse und mit CandidateHandle gleich n bis (m-1) die Regionen der erfolglosen Kandidaten abgerufen werden.
Es werden XLD Konturen ausgegeben, welche die einzelnen Striche innerhalb der Scanlinien darstellen. Das Auslesen der Scanlinien kann nur erfolgen, wenn der Barcode mit find_bar_code oder decode_bar_code_rectangle2 im 'persistence'-Modus gelesen wurde (siehe set_bar_code_param). 'scanlines_all' stellt alle Scanlinien dar, die von find_bar_code möglicherweise angelegt werden, um einen Barcode zu dekodieren. 'scanlines_valid' stellt nur diejenige 'scanlines_all' dar, die erfolgreich dekodiert werden können. Bei einzeiligen Barcodes gibt es mindestens eine 'scanlines_valid' je erfolgreich dekodiertem Barcodesymbol. Im Gegensatz dazu liefert 'scanlines_valid' leere Objekte wenn die Dekodierung des Symbols erfolglos war. Diese Regel ist für gestapelte Codes (wie z.B. 'GS1 DataBar Stacked' und 'GS1 DataBar Expanded Stacked') ähnlich, allerdings bezieht sie sich auf die einzelnen Zeilen, anstatt auf das ganze Barcodesymbol. 'scanlines_merged_edges' zeigt die Scanlinien und Kanten, die für die Dekodierung der vereinigten Scanlinie verwendet wurden (Siehe 'merge_scanlines' in set_bar_code_param).
'scanlines_all' stellt alle Scanlinien dar, die von find_bar_code möglicherweise angelegt werden, um einen Barcode zu dekodieren.
'scanlines_valid' stellt nur diejenigen Scanlinien dar, die erfolgreich dekodiert werden können. Bei einzeiligen Barcodes gibt es mindestens eine eine solche Scanlinie je erfolgreich dekodiertem Barcodesymbol. Die Mindestanzahl an Scanlinien, die erfolgreich gelesen werden können müssen, kann mit set_bar_code_param mit dem Parameter 'min_identical_scanlines' angepasst werden. Wenn die Dekodierung des Symbols erfolglos war, liefert 'scanlines_valid' leere Objekte. Diese Regel ist für gestapelte Codes (wie z.B. 'GS1 DataBar Stacked' und 'GS1 DataBar Expanded Stacked') ähnlich, allerdings bezieht sie sich auf die einzelnen Zeilen, anstatt auf das ganze Barcodesymbol.
'scanlines_merged_edges' zeigt die Scanlinien und Kanten, die für die Dekodierung der vereinigten Scanlinien verwendet wurden (siehe 'merge_scanlines' in set_bar_code_param).
get_bar_code_object gibt jede Scanlinie als eigene XLD Kontur zurück. Die XLD Konturen, die von 'scanlines_all' und 'scanlines_valid' zurückgegeben werden, sind nur zur Visualisierung gedacht und bestehen deshalb aus vielen XLD Punkten. Doppelte Linien werden zwischen Kanten benutzt, die als Striche erkannt wurden, während einfache Linien für weiße Leerräume benutzt werden. Zusätzliche Informationen über jede Scanlinie können mit get_bar_code_result mit dem Parameter 'status' erhalten werden.
Die '_plain'-Varianten 'scanlines_all_plain' und 'scanlines_valid_plain' geben die o.g. Scanlinien in vereinfachter Form zurück. Jede gefundene Kante wird hier als ein Punkt einer XLD-Kontur zurückgegeben, wobei für jede Scanlinie eine neue XLD-Kontur begonnen wird. Scanlinien, für die keine Kante gefunden wurde, werden nicht zurückgegeben.
Ikonische Objekte, die als Zwischenergebnisse bei der Barcode-Suche oder deren Auswertung anfallen.
Handle des zu verwendenden Barcode-Modells.
Auswahl der Barcode-Ergebnisse oder Kandidaten, für die eine Information abgefragt werden soll.
Defaultwert: 'all'
Wertevorschläge: 0, 1, 2, 'all'
Name des ikonischen Objekts, das abgefragt werden soll.
Defaultwert: 'candidate_regions'
Werteliste: 'candidate_regions', 'scanlines_all', 'scanlines_all_plain', 'scanlines_merged_edges', 'scanlines_valid', 'scanlines_valid_plain', 'symbol_regions'
get_bar_code_object liefert den Wert 2 (H_MSG_TRUE), falls die übergebenen Parameter korrekt und die angeforderten Objekte für die letzte Symbolsuche verfügbar sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.
Bar Code
| Operatoren |