decode_bar_code_rectangle2T_decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2 (Operator)

Name

decode_bar_code_rectangle2T_decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2 — Lesen von Barcode-Symbolen innerhalb eines Rechtecks.

Signatur

Beschreibung

Der Operator decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2 benutzt das durch BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandlebar_code_handle angegebene Barcode-Modell um einen Barcode an einer vorgegebenen Position innerhalb des Bildes ImageImageImageImageimageimage zu dekodieren. BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandlebar_code_handle muss mit create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModelcreate_bar_code_model erstellt worden sein. Dessen Parameter können mit set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param gesetzt werden. Die Position des Barcodes wird als beliebig orientiertes Rechteck übergeben. Im Gegensatz zu find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code, wo der Dekodierung eine zeitaufwändige Suche nach Kandidatenregionen vorangeht, durchsucht decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2 die übergebene Region direkt nach Barcodes. Die rechteckige Region wird definiert mit den Parametern RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn für den Schwerpunkt, PhiPhiPhiPhiphiphi für die Orientierung und Length1Length1Length1Length1length1length_1 und Length2Length2Length2Length2length2length_2 für die halbe Länge der Rechteckseiten (vergleiche gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2). Der Winkel PhiPhiPhiPhiphiphi legt auch die Leserichtung des Barcodes fest. Die Orientierung eines Barcodes ist der Winkel zwischen der Leserichtung des Barcodes und der horizontalen Bildachse. Der Winkel ist positiv bei Drehung nach links und wird wie bei gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2 in Bogenmaß angegeben. Dies ist entgegengesetzt zu den Operatoren get_bar_code_resultget_bar_code_resultGetBarCodeResultGetBarCodeResultGetBarCodeResultget_bar_code_result und set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param bei denen Winkelangaben in Grad angegeben werden. PhiPhiPhiPhiphiphi kann im Wertebereich von liegen. Die Leserichtung ist senkrecht zu den Kanten der einzelnen Barcodestriche. Es werden auch Barcodes mit einer Leserichtung von zurückgegeben. Mehrere Regionen zur Dekodierung können als Tupel in RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, PhiPhiPhiPhiphiphi, Length1Length1Length1Length1length1length_1 und Length2Length2Length2Length2length2length_2 übergeben werden.

Das Rechteck sollte den Barcode und die Ruhezonen vollständig überdecken. Zu groß gewählte Regionen werden dekodiert, falls in dieser Region keine störenden Muster auftauchen und die Höhe (Length2Length2Length2Length2length2length_2) klein genug ist, dass die Scanlinien genügend dicht gelegt werden können. Rechtecke, die in Leserichtung (Length1Length1Length1Length1length1length_1) zu kurz gewählt sind, können nicht dekodiert werden.

decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2 kann dann verwendet werden, wenn die Position des Barcodes bereits im Voraus bekannt ist. Beispielsweise könnten durch find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code und get_bar_code_objectget_bar_code_objectGetBarCodeObjectGetBarCodeObjectGetBarCodeObjectget_bar_code_object bereits Kandidatenregionen für Barcodes vorliegen (siehe folgendes Beispiel).

Für den Parameter CodeTypeCodeTypeCodeTypeCodeTypecodeTypecode_type können mehrere Barcode-Typen angegeben werden, vergleiche Abschnitt Autodiskriminierung für find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code.

Die weiteren Aspekte der tatsächlichen Dekodierung werden bei dem Operator find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code beschrieben.

Ausführungsinformationen

• 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 unterstützt Cancel-Timeouts und Interrupts.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

• BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandlebar_code_handle

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

Beispiel (HDevelop)

read_image (Image, 'barcode/ean13/ean1301.png')
create_bar_code_model ([], [], BHandle)
find_bar_code (Image, SymReg, BHandle, '2/5 Industrial', Dec)
if (|Dec| == 0)
*     A 2/5 Industrial code wasn't found. Try decoding an EAN-13 code.
    get_bar_code_object (CandReg, BHandle, 'all', 'candidate_regions')
    smallest_rectangle2 (CandReg, R, C, Phi, L1, L2)
    decode_bar_code_rectangle2 (Image, BHandle, 'EAN-13', R, C, Phi, \
                                L1, L2, Dec)
endif

Ergebnis

decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2decode_bar_code_rectangle2 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_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModelcreate_bar_code_model, set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2

Nachfolger

get_bar_code_resultget_bar_code_resultGetBarCodeResultGetBarCodeResultGetBarCodeResultget_bar_code_result, get_bar_code_objectget_bar_code_objectGetBarCodeObjectGetBarCodeObjectGetBarCodeObjectget_bar_code_object, clear_bar_code_modelclear_bar_code_modelClearBarCodeModelClearBarCodeModelClearBarCodeModelclear_bar_code_model

Alternativen

find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code

Siehe auch

gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2

Modul

Bar Code