get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject (Operator)

Name

get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject — Zugriff auf ikonische Objekte, die bei der Suche und der Dekodierung von Barcodes angelegt werden bzw. diese beschreiben.

Signatur

get_bar_code_object( : BarCodeObjects : BarCodeHandle, CandidateHandle, ObjectName : )

Beschreibung

Der Operator get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject erlaubt den Zugriff auf ikonische Objekte, die beim letzten Aufruf von find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode 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 (ObjectNameObjectNameObjectNameObjectNameObjectNameobjectName) auch das zugrundeliegende Barcode-Modell (BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle) angegeben werden. Außerdem muss in CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle ein Index auf ein dekodiertes Symbol oder einen Symbolkandidaten, bzw. 'all'"all""all""all""all""all" für alle dekodierten Symbole oder Symbolkandidaten übergeben werden.

Je nachdem wie der Parameter ObjectNameObjectNameObjectNameObjectNameObjectNameobjectName ausgewählt ist, werden die Ausgabeobjekten in BarCodeObjectsBarCodeObjectsBarCodeObjectsBarCodeObjectsBarCodeObjectsbarCodeObjects zurückgeliefert, wie folgend:

'symbol_regions'"symbol_regions""symbol_regions""symbol_regions""symbol_regions""symbol_regions":

Die Regionen von erfolgreich dekodierten Symbolen werden zurückgegeben. Die Reihenfolge der Objekte entspricht der Reihenfolge der dekodierten Zeichenfolgen im Operator get_bar_code_resultget_bar_code_resultGetBarCodeResultget_bar_code_resultGetBarCodeResultGetBarCodeResult. Mit CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle gleich 'all'"all""all""all""all""all" werden alle Regionen ausgegeben, während mit CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle gleich einer Zahl n nur die Region für das n-te Ergebnis ausgegeben wird.

'candidate_regions'"candidate_regions""candidate_regions""candidate_regions""candidate_regions""candidate_regions":

Die potentiellen Barcode-Regionen werden ausgegeben. Gibt es insgesamt m Kandidaten und n erfolgreiche Ergebnisse, so können mit CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle gleich 0 bis (n-1) die ursprünglichen Regionen der entsprechenden Ergebnisse und mit CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle gleich n bis (m-1) die Regionen der erfolglosen Kandidaten abgerufen werden.

'scanlines_all'"scanlines_all""scanlines_all""scanlines_all""scanlines_all""scanlines_all", 'scanlines_valid'"scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid", 'scanlines_all_plain'"scanlines_all_plain""scanlines_all_plain""scanlines_all_plain""scanlines_all_plain""scanlines_all_plain", 'scanlines_valid_plain'"scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain":

Es werden XLD Konturen ausgegeben, welche die einzelnen Striche innerhalb der Scanlinien darstellen. Das Auslesen der Scanlinien erfolgt nur, wenn der Barcode mit find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode oder decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2 im 'persistence'"persistence""persistence""persistence""persistence""persistence"-Modus gelesen wurde (siehe set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam). 'scanlines_all'"scanlines_all""scanlines_all""scanlines_all""scanlines_all""scanlines_all" stellt alle Scanlinien dar, die von find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode möglicherweise angelegt werden, um einen Barcode zu dekodieren. 'scanlines_valid'"scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid" stellt nur diejenige 'scanlines_all'"scanlines_all""scanlines_all""scanlines_all""scanlines_all""scanlines_all" dar, die erfolgreich dekodiert werden können. Bei einzeiligen Barcodes gibt es mindestens eine 'scanlines_valid'"scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid" je erfolgreich dekodiertem Barcodesymbol. Im Gegensatz dazu liefert 'scanlines_valid'"scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid" leere Objekte wenn die Dekodierung des Symbols erfolglos war. Diese Regel ist für gestapelte Codes (wie z.B. 'GS1 DataBar Stacked'"GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked" und 'GS1 DataBar Expanded Stacked'"GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked") ähnlich, allerdings bezieht sie sich auf die einzelnen Zeilen, anstatt auf das ganze Barcodesymbol. get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject gibt jede Scanlinie als eigene XLD Kontur zurück. Falls CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle auf 'all'"all""all""all""all""all" gesetzt wird, werden alle Scanlinien in allen Kandidatenregionen zurückgegeben. Falls nur Scanlinien einer bestimmten Kandidatenregion zurückgegeben werden sollen, muss die Nummer der Kandidatenregion in CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle angegeben werden. Die XLD Konturen die von 'scanlines_all'"scanlines_all""scanlines_all""scanlines_all""scanlines_all""scanlines_all" und 'scanlines_valid'"scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid""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 Information über jede Scanlinie kann mit get_bar_code_resultget_bar_code_resultGetBarCodeResultget_bar_code_resultGetBarCodeResultGetBarCodeResult mit dem Parameter 'status'"status""status""status""status""status" erhalten werden. Die '_plain'-Varianten 'scanlines_all_plain'"scanlines_all_plain""scanlines_all_plain""scanlines_all_plain""scanlines_all_plain""scanlines_all_plain" und 'scanlines_valid_plain'"scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain""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.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

BarCodeObjectsBarCodeObjectsBarCodeObjectsBarCodeObjectsBarCodeObjectsbarCodeObjects (output_object) object(-array) → object

Ikonische Objekte, die als Zwischenergebnisse bei der Barcode-Suche oder deren Auswertung anfallen.

BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle (input_control) barcode → (integer)

Handle des zu verwendenden Barcode-Modells.

CandidateHandleCandidateHandleCandidateHandleCandidateHandleCandidateHandlecandidateHandle (input_control) integer → (string / integer)

Auswahl der Barcode-Ergebnisse oder Kandidaten, für die eine Information abgefragt werden soll.

Defaultwert: 'all' "all" "all" "all" "all" "all"

Wertevorschläge: 0, 1, 2, 'all'"all""all""all""all""all"

ObjectNameObjectNameObjectNameObjectNameObjectNameobjectName (input_control) string → (string)

Name des ikonischen Objekts, das abgefragt werden soll.

Defaultwert: 'candidate_regions' "candidate_regions" "candidate_regions" "candidate_regions" "candidate_regions" "candidate_regions"

Werteliste: 'candidate_regions'"candidate_regions""candidate_regions""candidate_regions""candidate_regions""candidate_regions", 'scanlines_all'"scanlines_all""scanlines_all""scanlines_all""scanlines_all""scanlines_all", 'scanlines_all_plain'"scanlines_all_plain""scanlines_all_plain""scanlines_all_plain""scanlines_all_plain""scanlines_all_plain", 'scanlines_valid'"scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid""scanlines_valid", 'scanlines_valid_plain'"scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain""scanlines_valid_plain", 'symbol_regions'"symbol_regions""symbol_regions""symbol_regions""symbol_regions""symbol_regions"

Ergebnis

get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject 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.