gen_2d_bar_code_descrT_gen_2d_bar_code_descrGen2dBarCodeDescrgen_2d_bar_code_descrGen2dBarCodeDescrGen2dBarCodeDescr (Operator)

Name

gen_2d_bar_code_descrT_gen_2d_bar_code_descrGen2dBarCodeDescrgen_2d_bar_code_descrGen2dBarCodeDescrGen2dBarCodeDescr — Erzeugen einer generischen Beschreibung einer 2D-Barcodeklasse.

Warnung

gen_2d_bar_code_descrgen_2d_bar_code_descrGen2dBarCodeDescrgen_2d_bar_code_descrGen2dBarCodeDescrGen2dBarCodeDescr 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

Beschreibung

gen_2d_bar_code_descrgen_2d_bar_code_descrGen2dBarCodeDescrgen_2d_bar_code_descrGen2dBarCodeDescrGen2dBarCodeDescr erzeugt eine generische Beschreibung für einen zweidimensionalen Barcode. Zu den Bestandteilen einer solchen Beschreibung gehören der Barcodetyp sowie weitere charakteristische Merkmale der gesuchten Codes.

Der Barcodetyp wird im Parameter CodeTypeCodeTypeCodeTypeCodeTypeCodeTypecodeType übergeben. Zur Zeit werden die folgenden 2D-Barcodes unterstützt:

'Data Matrix ECC 200'

Data Matrix mit ECC 200 Kodierung.

Die Beschreibung der Barcodes erfolgt mit Hilfe generischer Parameter. Dafür können in den Parametern GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames und GenParamValuesGenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues Paare von Descriptoren und Werten übergeben werden. Die folgenden generischen Parameter beschreiben die Größe und Form des Symbols:

'columns'        Exakte Anzahl der Spalten des Symbols.
                 GenParamValues: 10, 12, 14, 16, 18, 20, 22, 24, 26, 32, 36,
                                 40, 44, 48, 52, 64, 72, 80, 88, 96, 104,
                                 120, 132, 144
                 default:        -

'columns_min'    Mindestanzahl an Spalten.
                 GenParamValues: 10...144 (gerade)
                 default:        10

'columns_max'    Maximalanzahl an Spalten.
                 GenParamValues: 10...144 (gerade)
                 default:        144

'rows'           Exakte Anzahl der Zeilen des Symbols.
                 GenParamValues: 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 32,
                                 36, 40, 44, 48, 52, 64, 72, 80, 88, 96,
                                 104, 120, 132, 144
                 default:        -

'rows_min'       Mindestanzahl an Zeilen.
                 GenParamValues: 8...144 (gerade)
                 default:        8

'rows_max'       Maximalanzahl an Zeilen.
                 GenParamValues: 8...144 (gerade)
                 default:        144

'shape'          Form des Symbols.
                 GenParamValues: 'square':    quadratisch
                                 'rectangle': rechteckig
                                 'any':       beliebig
                 default:        'any'

Die folgenden generischen Parameter beschreiben den Druck bzw. das Erscheinungsbild des Barcodes:

'foreground'     Färbung gesetzter Bits (Vordergrund).

                 2D-Barcodes können sowohl schwarz-auf-weiß als auch
                 umgekehrt gedruckt werden. Ist bekannt, ob gesetzte Bits
                 hell oder dunkel sind, kann durch Angabe dieser Information
                 Rechenzeit gespart werden, insbesondere beim Suchen der
                 Symbolkandidaten (Operator find_2d_bar_codefind_2d_bar_codeFind2dBarCodefind_2d_bar_codeFind2dBarCodeFind2dBarCode).

                 GenParamValues: 'any':   beliebig
                                 'dark','black':  dunkler Druck auf hellem Hintergrund
                                                  (schwarz auf weiß)
                                 'light','white': heller Druck auf dunklem Hintergrund
                                                  (weiß auf schwarz)
                 default:        'any'

'mode'           Modus beim Druck des Barcodes.

                 Durch Angabe dieses Parameters wird ein für eine spezielle
                 Druckmethode optimiertes Bildverarbeitungsverfahren ausgewählt.

                 GenParamValues: 'printed':             Normaler Schwarz-Weiß-Druck. Module erscheinen
                                                        als Quadrate; benachbarte Module mit gleichem
                                                        Wert verlaufen zu einer Region.

                                 'engraved_darkfield':  Die Bits werden z.B. mit Laser in die
                                                        Oberfläche gebrannt. Bei Dunkelfeld-
                                                        Beleuchtung erscheinen Module mit Wert 1
                                                        als dunkle runde Punkte mit weißer Korona;
                                                        benachbarte Module mit dem Wert 1
                                                        werden also durch Zwischenräume getrennt.

                                 'engraved_lightfield': Wie 'engraved_darkfield', aber mit Hellfeld-
                                                        Beleuchtung. Module mit Wert 1
                                                        erscheinen als helle Punkte mit dunkler
                                                        Korona; benachbarte Module mit dem Wert 1
                                                        werden durch Zwischenräume getrennt.

                 default:        'printed'

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

Beispiel (HDevelop)

gen_2d_bar_code_descr ('Data Matrix ECC 200', ['mode','foreground'], \
                       ['printed','dark'], BarCodeDescr)

Ergebnis

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

Modul

Data Code