get_2d_bar_code_posT_get_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos (Operator)

Name

get_2d_bar_code_posT_get_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos — Bestimmen der Datenwerte der Elemente (in ECC 200: „Module“) innerhalb einer Barcode-Region („Data Matrix Symbol“) und ihrer Positionen im Bild.

Warnung

get_2d_bar_code_posget_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos 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

get_2d_bar_code_posget_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos extrahiert aus einem Symbolkandidaten BarCodeRegionBarCodeRegionBarCodeRegionBarCodeRegionBarCodeRegionbarCodeRegion und den dazugehörigen Grauwerten ImageImageImageImageImageimage die einzelnen Datenwerte (Bit gesetzt oder nicht). Im Gegensatz zu get_2d_bar_codeget_2d_bar_codeGet2dBarCodeget_2d_bar_codeGet2dBarCodeGet2dBarCode werden zusätzlich die Positionen der einzelnen Datenelemente im Bild in den Parametern DataElementRowDataElementRowDataElementRowDataElementRowDataElementRowdataElementRow und DataElementColDataElementColDataElementColDataElementColDataElementColdataElementCol zurück geliefert. Diese können dann zur Kontrolle der Funktion des Operators zum Einzeichnen der Daten in das Ausgangsbild verwendet werden. Für die Beschreibung der anderen Parameter siehe get_2d_bar_codeget_2d_bar_codeGet2dBarCodeget_2d_bar_codeGet2dBarCodeGet2dBarCode.

Achtung

Der Operator get_2d_bar_code_posget_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos signalisiert über den Fehlercode, dass die übergebene Region keinen gültigen Barcode enthält. Da die vom Operator find_2d_bar_codefind_2d_bar_codeFind2dBarCodefind_2d_bar_codeFind2dBarCodeFind2dBarCode extrahierten Regionenkandidaten aber durchaus Regionen ohne Barcode enthalten können, sollte jeder Aufruf von get_2d_bar_codeget_2d_bar_codeGet2dBarCodeget_2d_bar_codeGet2dBarCodeGet2dBarCode in eine eigene Fehlerbehandlung eingeschlossen werden (siehe Beispiel).

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)

dev_set_check ('~give_error')
get_2d_bar_code_pos (ObjectSelected, Image, BarCodeDescr, \
                     CodeRegDescr, [], [], BarCodeDimension, BarCodeData, \
                     DataElementRow, DataElementCol)
err := ErrorCode
dev_set_check ('give_error')
if (err = 2)
  idx := 0
  dev_update_pc ('off')
  dev_update_time ('off')
  dev_update_var ('off')
  for m := 0 to BarCodeDimension[0]-1 by 1
    for n := 0 to BarCodeDimension[1]-1 by 1
      if (BarCodeData[idx]>0)
        set_color (WindowHandle, 'green')
      else
        if (BarCodeData[idx]<0)
          set_color (WindowHandle, 'red')
        else
          set_color (WindowHandle, 'blue')
        endif
      endif
      disp_circle (WindowHandle, DataElementRow[idx], \
                   DataElementCol[idx], 1)
      idx := idx+1
    endfor
  endfor
  dev_update_pc ('on')
  dev_update_time ('on')
  dev_update_var ('on')
  decode_2d_bar_code (BarCodeDescr, BarCodeDimension, BarCodeData, \
                      SymbolCharacters, CorrSymbolData, DecodedData, \
                      DecodingError, StructuredAppend)
endif

Ergebnis

Der Operator get_2d_bar_code_posget_2d_bar_code_posGet2dBarCodePosget_2d_bar_code_posGet2dBarCodePosGet2dBarCodePos signalisiert über den Fehlercode sowohl, dass inkorrekte Parameter übergeben wurden als auch, dass die Extraktion eines Barcodes aus der übergebenen Region aus bestimmten Gründen scheiterte. Konnte z.B. kein umschließendes Viereck um die Region bestimmt werden, wird der Operator mit dem Fehlercode 8808 abgebrochen. Liegt das Viereck z.T. außerhalb des Bildes, wird mit dem Fehlercode 8807 abgebrochen. Wurde innerhalb des Randbereichs kein Suchmuster gefunden, wird der Operator mit dem Fehlercode 8810 abgebrochen. Wird dagegen der durchgezogener Symbolrand an zwei aneinanderstoßenden Seiten ('L') nicht gefunden, wird mit dem Fehlercode 8809 abgebrochen. Kann bei der Druckmethode 'engraved_darkfield'"engraved_darkfield""engraved_darkfield""engraved_darkfield""engraved_darkfield""engraved_darkfield" keines der Grauwertmerkmale die Testregionen trennen, bricht der Operator mit dem Fehlercode 8811 ab.

Modul

Data Code