decode_2d_bar_codeT_decode_2d_bar_codeDecode2dBarCodedecode_2d_bar_codeDecode2dBarCodeDecode2dBarCode (Operator)

Name

decode_2d_bar_codeT_decode_2d_bar_codeDecode2dBarCodedecode_2d_bar_codeDecode2dBarCodeDecode2dBarCode — Decodieren von 2D-Barcode-Daten.

Warnung

decode_2d_bar_codedecode_2d_bar_codeDecode2dBarCodedecode_2d_bar_codeDecode2dBarCodeDecode2dBarCode ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt. Neue Applikationen sollten stattdessen die Funktionalität im Kapitel Identifizierung / Datacode verwenden zum Lesen von 2D-Datacode-Symbologien verwenden (siehe create_data_code_2d_modelcreate_data_code_2d_modelCreateDataCode2dModelcreate_data_code_2d_modelCreateDataCode2dModelCreateDataCode2dModel).

Signatur

decode_2d_bar_code( : : BarCodeDescr, BarCodeDimension, BarCodeData : SymbolCharacters, CorrSymbolData, DecodedData, DecodingError, StructuredAppend)

Beschreibung

decode_2d_bar_codedecode_2d_bar_codeDecode2dBarCodedecode_2d_bar_codeDecode2dBarCodeDecode2dBarCode dekodiert binäre 2D-Barcode-Daten, die mit Hilfe von get_2d_bar_codeget_2d_bar_codeGet2dBarCodeget_2d_bar_codeGet2dBarCodeGet2dBarCode oder get_2d_bar_code_posget_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos gelesen wurden. Der Parameter BarCodeDataBarCodeDataBarCodeDataBarCodeDataBarCodeDatabarCodeData enthält die Datenwerte, BarCodeDimensionBarCodeDimensionBarCodeDimensionBarCodeDimensionBarCodeDimensionbarCodeDimension die Breite und Höhe des Datenfeldes und einen Symbol-Index, BarCodeDescrBarCodeDescrBarCodeDescrBarCodeDescrBarCodeDescrbarCodeDescr die Beschreibung der Barcodeklasse.

Zuerst werden die binären Daten des Symbols vollständig in einen Strom von 8-Bit-Zeichen umgewandelt (SymbolCharactersSymbolCharactersSymbolCharactersSymbolCharactersSymbolCharacterssymbolCharacters). Dieser Datenstrom besteht aus den eigentlichen (möglicherweise fehlerbehafteten) Daten sowie zusätzlichen Zeichen für die Fehlerkorrektur. Konnte aus diesem Datenstrom ein fehlerfreier Datensatz rekonstruiert werden, steht dieser, immer noch in kodierter Form, in CorrSymbolDataCorrSymbolDataCorrSymbolDataCorrSymbolDataCorrSymbolDatacorrSymbolData. DecodingErrorDecodingErrorDecodingErrorDecodingErrorDecodingErrordecodingError enthält die Anzahl der korrigierten Fehler oder einen negativen Fehlercode, falls eine Korrektur nicht möglich war.

In einem letzten Schritt werden die Daten dekodiert und als Tupel von ASCII-Zeichen in DecodedDataDecodedDataDecodedDataDecodedDataDecodedDatadecodedData abgelegt. Ist das untersuchte Symbol Bestandteil einer Gruppe von zusammengehörigen Symbolen (ECC 200: „Structured Append“), enthält der Parameter StructuredAppendStructuredAppendStructuredAppendStructuredAppendStructuredAppendstructuredAppend die Nummer der Symbols in der Reihe, die Anzahl zusammengehöriger Symbole sowie eine Zahl als Identifikator der Gruppe. Ansonsten steht in den ersten beiden Feldern von StructuredAppendStructuredAppendStructuredAppendStructuredAppendStructuredAppendstructuredAppend jeweils eine 1.

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

BarCodeDescrBarCodeDescrBarCodeDescrBarCodeDescrBarCodeDescrbarCodeDescr (input_control) barcode_2d → (string / integer / real)

Beschreibung der 2D-Barcodeklasse

BarCodeDimensionBarCodeDimensionBarCodeDimensionBarCodeDimensionBarCodeDimensionbarCodeDimension (input_control) integer-array → (integer)

Tupel mit der Dimension des untersuchten Symbols. Bei ECC 200: Datenfeldbreite, -höhe, Symbol-Index.

BarCodeDataBarCodeDataBarCodeDataBarCodeDataBarCodeDatabarCodeData (input_control) integer-array → (integer)

Tupel mit der Datenwerten des untersuchten Symbols.

SymbolCharactersSymbolCharactersSymbolCharactersSymbolCharactersSymbolCharacterssymbolCharacters (output_control) string-array → (string)

Symbol-Rohdaten (Daten- und Fehlerzeichen).

CorrSymbolDataCorrSymbolDataCorrSymbolDataCorrSymbolDataCorrSymbolDatacorrSymbolData (output_control) integer-array → (integer)

Fehlerbereinigte Symboldaten.

DecodedDataDecodedDataDecodedDataDecodedDataDecodedDatadecodedData (output_control) integer-array → (integer)

Dekodierte Zeichen als Zahlenwerte.

DecodingErrorDecodingErrorDecodingErrorDecodingErrorDecodingErrordecodingError (output_control) integer → (integer)

Anzahl der Fehler bei der Dekodierung.

StructuredAppendStructuredAppendStructuredAppendStructuredAppendStructuredAppendstructuredAppend (output_control) integer-array → (integer)

Bei Zugehörigkeit des Symbols zu einer Gruppe von Symbolen: Position in der Gruppe, Anzahl der Symbole, Gruppen-ID.

Ergebnis

Der Operator decode_2d_bar_codedecode_2d_bar_codeDecode2dBarCodedecode_2d_bar_codeDecode2dBarCodeDecode2dBarCode signalisiert über den Fehlercode sowohl, dass inkorrekte Parameter übergeben wurden, als auch, dass ein Fehler beim Dekodieren des Datenstroms aufgetreten ist. Der Fehlercode 8812 bedeutet hierbei, dass der dekodierte Datenstrom ein ungültiges Datenwort enthielt. Das Auftreten benutzerdefinierter Steuerwörter führt zu einem Abbruch mit dem Fehlercode 8813.

Modul

Data Code

Operatoren