find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode (Operator)

Name

find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode — Suchen und Lesen von Barcode-Symbolen im Eingabebild.

Signatur

Beschreibung

Der Operator find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode sucht im Eingabebild (ImageImageImageImageImageimage) nach Barcode-Symbolen und dekodiert die darin enthaltenen Zeichenfolgen. In einem Bild kann eine beliebige Anzahl an Barcodes eines Typs gefunden und dekodiert werden, wobei der Typ des gesuchten Barcodes mit CodeTypeCodeTypeCodeTypeCodeTypeCodeTypecodeType ausgewählt wird. Die gelesenen Zeichenfolgen werden in DecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsdecodedDataStrings und die dazu korrespondierenden Barcode-Regionen in SymbolRegionsSymbolRegionsSymbolRegionsSymbolRegionsSymbolRegionssymbolRegions zurück gegeben. Werden insgesamt n Barcodes erfolgreich gelesen, so können die Indizes von 0 bis (n-1) in den Operatoren get_bar_code_resultget_bar_code_resultGetBarCodeResultget_bar_code_resultGetBarCodeResultGetBarCodeResult und get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject verwendet werden, um die gewünschte Information eines speziellen Ergebnisse zu erhalten.

Es wird angenommen, dass die Barcodes dunkel auf einem hellen Hintergrund erscheinen. Um helle Barcodes auf einem dunklen Hintergrund lesen zu können, muss das Eingabebild vorher mit dem Operator invert_imageinvert_imageInvertImageinvert_imageInvertImageInvertImage invertiert werden.

Vor dem Aufruf des Operators find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode muss mit Hilfe von create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel ein Barcode-Modell erstellt und der dabei erzeugte Handle in BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle an find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode übergeben werden.

Der Ausgabewert DecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsdecodedDataStrings gibt für jedes Ergebnis die dekodierte Zeichenfolge zurück. Der Inhalt dieser Zeichenfolge wird durch den Standard des entsprechenden Codetyps bestimmt. Typischerweise enthält DecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsdecodedDataStrings nur die Zeichen mit Dateninformation. Bei Codes mit obligatorischem Prüfzeichen wird dieses nicht mit ausgegeben. Bei Codes mit optionalem Prüfzeichen, z.B. Code 39, Codabar, 2/5 Industrial oder 2/5 Interleaved, hängt das Ergebnis von der Einstellung des Parameters 'check_char'"check_char""check_char""check_char""check_char""check_char" ab, welcher in create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel, set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam oder set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecific einstellbar ist: Der Standardwert von 'absent'"absent""absent""absent""absent""absent" gibt an, dass kein Prüfzeichen vorliegt. In diesem Fall wird keine Prüfung durchgeführt, und alle Zeichen werden als Daten zurückgeliefert. Ist dieser Parameter auf 'present'"present""present""present""present""present" gesetzt, so wird ein Prüfzeichen erwartet und benutzt um die Korrektheit des Barcodes zu prüfen. Ist die Prüfsumme fehlerhaft, so wird der Code als nicht lesbar eingestuft und dementsprechend auch nicht als Ergebnis in DecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsDecodedDataStringsdecodedDataStrings und SymbolRegionsSymbolRegionsSymbolRegionsSymbolRegionsSymbolRegionssymbolRegions zurückgeliefert. Das Prüfzeichen selbst wird aus den Nutzdaten entfernt. Falls dies nicht erwünscht ist, kann der Parameterwert 'preserved'"preserved""preserved""preserved""preserved""preserved" eingestellt werden um das Prüfzeichen trotz Prüfung zu erhalten.

Die zu Grunde liegenden Referenz-Zeichen, einschließlich möglicher Start- oder Stopzeichen sowie Prüfzeichen, können mit get_bar_code_resultget_bar_code_resultGetBarCodeResultget_bar_code_resultGetBarCodeResultGetBarCodeResult und 'decoded_reference'"decoded_reference""decoded_reference""decoded_reference""decoded_reference""decoded_reference" abgefragt werden.

Folgende Barcode-Symbole werden unterstützt:

Anmerkung: Da die Leserichtung beim PharmaCode nicht bestimmt werden kann, werden auch die beiden Zeichenketten für jede Leserichtung zurückgegeben. Beide Zeichenketten werden in einer Zeichenkette durch ein Komma getrennt aneinandergehängt.

Barcodes vom Typ GS1 DataBar können zusätzlich eine Composite-Code-Komponente enthalten. Um diese Komponente finden und dekodieren zu können, muss mittels des Operators set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam der Parameter 'composite_code'"composite_code""composite_code""composite_code""composite_code""composite_code" auf 'CC-A/B'"CC-A/B""CC-A/B""CC-A/B""CC-A/B""CC-A/B" gesetzt werden.

Es können auch Barcodes vom Typ 'Code 32' gelesen werden, indem der Operator find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode mit CodeTypeCodeTypeCodeTypeCodeTypeCodeTypecodeType 'Code 39'"Code 39""Code 39""Code 39""Code 39""Code 39" in Kombination mit der externen Prozedur convert_decoded_string_code39_to_code32 verwendet wird.

Autodiskriminierung

Autodiskriminierung beschreibt das gleichzeitige Lesen mehrerer Barcode-Typen in einem Aufruf von find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode. Dazu wird dem Parameter CodeTypeCodeTypeCodeTypeCodeTypeCodeTypecodeType ein Tupel von möglichen Barcode-Typen übergeben. Mit dem speziellen Wert 'auto'"auto""auto""auto""auto""auto" werden alle Barcode-Typen dekodiert, mit Ausnahme von 'PharmaCode'"PharmaCode""PharmaCode""PharmaCode""PharmaCode""PharmaCode" und 'MSI'"MSI""MSI""MSI""MSI""MSI", da diese zu wenige Merkmale bieten um von anderen Barcode-Typen abgegrenzt werden zu können. In dem Tupel können auch Barcode-Typen mit vorangestellter Tilde (~) angegeben werden, welche dann nicht dekodiert werden. So bezeichnet beispielsweise

['auto'"auto""auto""auto""auto""auto", '~EAN-8'"~EAN-8""~EAN-8""~EAN-8""~EAN-8""~EAN-8", '~EAN-8 Add-On 2'"~EAN-8 Add-On 2""~EAN-8 Add-On 2""~EAN-8 Add-On 2""~EAN-8 Add-On 2""~EAN-8 Add-On 2", '~EAN-8 Add-On 5'"~EAN-8 Add-On 5""~EAN-8 Add-On 5""~EAN-8 Add-On 5""~EAN-8 Add-On 5""~EAN-8 Add-On 5"]

Der Barcode-Leser versucht die Barcode-Typen in der folgenden Reihenfolge zu dekodieren:

'GS1 DataBar Omnidir'"GS1 DataBar Omnidir""GS1 DataBar Omnidir""GS1 DataBar Omnidir""GS1 DataBar Omnidir""GS1 DataBar Omnidir", 'GS1 DataBar Truncated'"GS1 DataBar Truncated""GS1 DataBar Truncated""GS1 DataBar Truncated""GS1 DataBar Truncated""GS1 DataBar Truncated", 'GS1 DataBar Stacked'"GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked", 'GS1 DataBar Stacked Omnidir'"GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir", 'GS1 DataBar Limited'"GS1 DataBar Limited""GS1 DataBar Limited""GS1 DataBar Limited""GS1 DataBar Limited""GS1 DataBar Limited", 'GS1 DataBar Expanded'"GS1 DataBar Expanded""GS1 DataBar Expanded""GS1 DataBar Expanded""GS1 DataBar Expanded""GS1 DataBar Expanded", 'GS1 DataBar Expanded Stacked'"GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked", 'GS1-128'"GS1-128""GS1-128""GS1-128""GS1-128""GS1-128", 'Code 128'"Code 128""Code 128""Code 128""Code 128""Code 128", 'EAN-13 Add-On 5'"EAN-13 Add-On 5""EAN-13 Add-On 5""EAN-13 Add-On 5""EAN-13 Add-On 5""EAN-13 Add-On 5", 'EAN-13 Add-On 2'"EAN-13 Add-On 2""EAN-13 Add-On 2""EAN-13 Add-On 2""EAN-13 Add-On 2""EAN-13 Add-On 2", 'EAN-13'"EAN-13""EAN-13""EAN-13""EAN-13""EAN-13", 'UPC-A Add-On 5'"UPC-A Add-On 5""UPC-A Add-On 5""UPC-A Add-On 5""UPC-A Add-On 5""UPC-A Add-On 5", 'UPC-A Add-On 2'"UPC-A Add-On 2""UPC-A Add-On 2""UPC-A Add-On 2""UPC-A Add-On 2""UPC-A Add-On 2", 'UPC-A'"UPC-A""UPC-A""UPC-A""UPC-A""UPC-A", 'EAN-8 Add-On 5'"EAN-8 Add-On 5""EAN-8 Add-On 5""EAN-8 Add-On 5""EAN-8 Add-On 5""EAN-8 Add-On 5", 'EAN-8 Add-On 2'"EAN-8 Add-On 2""EAN-8 Add-On 2""EAN-8 Add-On 2""EAN-8 Add-On 2""EAN-8 Add-On 2", 'EAN-8'"EAN-8""EAN-8""EAN-8""EAN-8""EAN-8", 'UPC-E Add-On 5'"UPC-E Add-On 5""UPC-E Add-On 5""UPC-E Add-On 5""UPC-E Add-On 5""UPC-E Add-On 5", 'UPC-E Add-On 2'"UPC-E Add-On 2""UPC-E Add-On 2""UPC-E Add-On 2""UPC-E Add-On 2""UPC-E Add-On 2", 'UPC-E'"UPC-E""UPC-E""UPC-E""UPC-E""UPC-E", 'Code 93'"Code 93""Code 93""Code 93""Code 93""Code 93", 'Code 39'"Code 39""Code 39""Code 39""Code 39""Code 39", 'Codabar'"Codabar""Codabar""Codabar""Codabar""Codabar", '2/5 Interleaved'"2/5 Interleaved""2/5 Interleaved""2/5 Interleaved""2/5 Interleaved""2/5 Interleaved", '2/5 Industrial'"2/5 Industrial""2/5 Industrial""2/5 Industrial""2/5 Industrial""2/5 Industrial"

Deshalb sollten mindestens alle nicht auftretenden Barcode-Typen ausgeschlossen werden die vor dem ersten der erwarteten Barcode-Typen dekodiert werden oder gleich nur die explizite Liste aller Barcode-Typen die erwartet werden.

Insbesondere für den Fall der Autodiskriminierung existiert der Operator set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecific. Einige Parameter des Barcode-Modells können damit spezifisch für verschiedene Barcode-Typen festgelegt werden.

Training

Falls sich der Barcode-Leser im Trainingsmodus befindet führt der Operator find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode einen Trainingslauf durch. Der Trainingmodus ist bei dem Operator set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam beschrieben.

Timeout und Abbruch

Der Operator find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode kann sowohl mit einem Timeout sowie auch manuell abgebrochen werden. Mit dem Operator set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam kann man einen Timeout festlegen. Falls find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode in einen Timeout läuft, werden alle bis dahin erkannten Codes zurückgegeben. Zusätzlich gibt es die Möglichkeit find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode manuell abzubrechen, indem man set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam mit 'abort' von einem anderen Thread aufruft.

In beiden Fällen, kann mit get_bar_code_resultget_bar_code_resultGetBarCodeResultget_bar_code_resultGetBarCodeResultGetBarCodeResult und dem Parameter 'aborted'"aborted""aborted""aborted""aborted""aborted" abgefragt werden, ob der Operator abgebrochen wurde.

Hinweise zur Verwendung von niedrig aufgelösten Bildern

Dieser Hinweis betrifft Barcode-Anwendungen, in denen niedrig aufgelöste Bilder verwendet werden, d.h. Bilder in denen ein einzelner Strich des Barcodes nur zwischen ein und zwei Pixeln breit ist.

In diesen Fällen sollte man bei der Bildaufnahme darauf achten, dass die Bilder möglichst scharf sind und gleichzeitig möglichst wenig Rauschen enthalten, da diese Fehler zu Problemen bei der Dekodierung von niedrig aufgelösten Barcodes führen können.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf interner Datenebene.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

• BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle

Parameter

Beispiel (HDevelop)

* Small example for aborting bar code search:
read_image (Image, 'barcode/ean13/tea_box_10.png')

* Decode normally:
create_bar_code_model ([], [], BarCodeHandle)
find_bar_code (Image, SymbolRegions, BarCodeHandle, 'auto', \
    DecodedDataStrings)
stop ()

* Start bar code search in separate thread.
par_start<ThreadID>: find_bar_code (Image, SymbolRegions1, BarCodeHandle, \
    'auto', DecodedDataStrings1)

* Let some time pass.
wait_seconds (0.002)

* Abort the data code search.
set_bar_code_param (BarCodeHandle, 'abort', 'true')

* Wait for the thread, it should finish very fast.
par_join(ThreadID)

* We can determine that the search in fact was aborted.
get_bar_code_result (BarCodeHandle, 'all', 'aborted', Aborted)

Ergebnis

find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode liefert den Wert 2 (H_MSG_TRUE), falls die übergebenen Parameter korrekt sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel, set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam

Nachfolger

get_bar_code_resultget_bar_code_resultGetBarCodeResultget_bar_code_resultGetBarCodeResultGetBarCodeResult, get_bar_code_objectget_bar_code_objectGetBarCodeObjectget_bar_code_objectGetBarCodeObjectGetBarCodeObject, clear_bar_code_modelclear_bar_code_modelClearBarCodeModelclear_bar_code_modelClearBarCodeModelClearBarCodeModel

Alternativen

decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2

Modul

Bar Code