get_data_code_2d_paramT_get_data_code_2d_paramGetDataCode2dParamGetDataCode2dParamget_data_code_2d_param (Operator)

Name

get_data_code_2d_paramT_get_data_code_2d_paramGetDataCode2dParamGetDataCode2dParamget_data_code_2d_param — Abfrage von einem oder mehreren Parametern, die das 2D-Datacode-Modell beschreiben.

Signatur

Beschreibung

Mit Hilfe des Operators get_data_code_2d_paramget_data_code_2d_paramGetDataCode2dParamGetDataCode2dParamGetDataCode2dParamget_data_code_2d_param lassen sich die Parameter, durch die das 2D-Datacode-Modell beschrieben wird, abfragen. Die Namen der Parameter, die abgefragt werden sollen, werden in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name übergeben, die korrespondierenden Werte werden in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value zurückgeliefert. Sämtliche Parameter können mit set_data_code_2d_paramset_data_code_2d_paramSetDataCode2dParamSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param gesetzt und jederzeit verändert werden. Eine Liste der Parameternamen, die für den ausgewählten 2D-Datacode-Type abgefragt werden können, liefert der Operator query_data_code_2d_paramsquery_data_code_2d_paramsQueryDataCode2dParamsQueryDataCode2dParamsQueryDataCode2dParamsquery_data_code_2d_params.

Das Konzept des 2D-Datacode-Lesers ist bei der Einleitung zu Kapitel Identifizierung / Datacode beschrieben.

Es ist zu beachten, dass die Symbolstruktur von GS1 DataMatrix, GS1 QR Code, GS1 Aztec Code und GS1 DotCode der Struktur von Data Matrix ECC 200, QR Code, Aztec Code, bzw. DotCode identisch ist. Deswegen gelten alle typspezifischen Parameter, Einstellungen und Regeln, die Data Matrix ECC 200, QR Code, Aztec Code oder DotCode betreffen, auch für ihre entsprechende GS1-Variante. Im Folgenden wird das ausführliche Auflisten typspezifischer Parameter einzelner GS1-Typen ausgelassen, um die Lesbarkeit der Dokumentation zu erleichtern. Stattdessen können die relevante Parameter eines GS1-Datacodetyps entweder von den Parametern von dessen nicht-GS1-Variante hergeleitet werden oder explizit durch query_data_code_2d_paramsquery_data_code_2d_paramsQueryDataCode2dParamsQueryDataCode2dParamsQueryDataCode2dParamsquery_data_code_2d_params mit dem Parameter 'get_model_params'"get_model_params""get_model_params""get_model_params""get_model_params""get_model_params" abgefragt werden.

Im Einzelnen kann auf die folgenden Parameter - gruppiert nach verschiedenen Kategorien und Datacode-Typen - zugegriffen werden:

Größe und Form des Symbols:

• Data Matrix ECC 200 (inklusive Finder-Pattern):

  'symbol_cols_min'"symbol_cols_min""symbol_cols_min""symbol_cols_min""symbol_cols_min""symbol_cols_min":

  Mindestanzahl der Spalten des Symbols in Modulen.

  'symbol_cols_max'"symbol_cols_max""symbol_cols_max""symbol_cols_max""symbol_cols_max""symbol_cols_max":

  Höchstanzahl der Spalten des Symbols in Modulen.

  'symbol_rows_min'"symbol_rows_min""symbol_rows_min""symbol_rows_min""symbol_rows_min""symbol_rows_min":

  Mindestanzahl der Zeilen des Symbols in Modulen.

  'symbol_rows_max'"symbol_rows_max""symbol_rows_max""symbol_rows_max""symbol_rows_max""symbol_rows_max":

  Höchstanzahl der Zeilen des Symbols in Modulen.

  'symbol_shape'"symbol_shape""symbol_shape""symbol_shape""symbol_shape""symbol_shape":

  Mögliche Einschränkungen hinsichtlich der Form des Symbols (Rechteck und/oder Quadrat): 'square'"square""square""square""square""square", 'rectangle'"rectangle""rectangle""rectangle""rectangle""rectangle" oder 'any'"any""any""any""any""any". Seit HALCON 7.1.1 werden bei der Symbolsuche beide Formen gleich behandelt.

• QR-Code (inklusive Finder-Pattern):

  'model_type'"model_type""model_type""model_type""model_type""model_type":

  Typ des QR-Code-Modells: 1, 2, 0 (für 'any'"any""any""any""any""any")

  'version_min'"version_min""version_min""version_min""version_min""version_min":

  Kleinste zu lesende Symbol-Version: [1..40] (Modelltyp 1: [1..14])

  'version_max'"version_max""version_max""version_max""version_max""version_max":

  Größte zu lesende Symbol-Version: [1..40] (Modelltyp 1: [1..14])

  'symbol_size_min'"symbol_size_min""symbol_size_min""symbol_size_min""symbol_size_min""symbol_size_min":

  Kleinste zu lesende Symbolgröße in Modulen (dieser Wert korrespondiert direkt mit 'version_min'"version_min""version_min""version_min""version_min""version_min"): [21..177] (Modelltyp 1: [21..73])

  'symbol_size_max'"symbol_size_max""symbol_size_max""symbol_size_max""symbol_size_max""symbol_size_max":

  Größte zu lesende Symbolgröße in Modulen (dieser Wert korrespondiert direkt mit 'version_max'"version_max""version_max""version_max""version_max""version_max"): [21..177] (Modelltyp 1: [21..73])

• PDF417:

  'symbol_cols_min'"symbol_cols_min""symbol_cols_min""symbol_cols_min""symbol_cols_min""symbol_cols_min":

  Mindestanzahl der Datenspalten des Symbols in Codewords (je 17 Module), d.h. exklusive der Codewords der Start/Stop-Patterns sowie der beiden Codewords der Row-Indicators.

  'symbol_cols_max'"symbol_cols_max""symbol_cols_max""symbol_cols_max""symbol_cols_max""symbol_cols_max":

  Höchstanzahl der Datenspalten des Symbols in Codewords (je 17 Module), d.h. exklusive der Codewords der Start/Stop-Patterns sowie der beiden Codewords der Row-Indicators.

  'symbol_rows_min'"symbol_rows_min""symbol_rows_min""symbol_rows_min""symbol_rows_min""symbol_rows_min":

  Mindestanzahl der Zeilen des Symbols in Modulen.

  'symbol_rows_max'"symbol_rows_max""symbol_rows_max""symbol_rows_max""symbol_rows_max""symbol_rows_max":

  Höchstanzahl der Zeilen des Symbols in Modulen.

• Aztec Code (inklusive Finder-Pattern):

  'format'"format""format""format""format""format":

  Format des Aztec Codes: Durch Leerzeichen getrennte Liste mit den Werten 'compact'"compact""compact""compact""compact""compact", 'full_range'"full_range""full_range""full_range""full_range""full_range" oder 'rune'"rune""rune""rune""rune""rune".

  'symbol_size_min'"symbol_size_min""symbol_size_min""symbol_size_min""symbol_size_min""symbol_size_min":

  Kleinste zu lesende Symbolgröße in Modulen: [11..151]

  'symbol_size_max'"symbol_size_max""symbol_size_max""symbol_size_max""symbol_size_max""symbol_size_max":

  Größte zu lesende Symbolgröße in Modulen: [11..151]

• DotCode:

  'symbol_cols_min'"symbol_cols_min""symbol_cols_min""symbol_cols_min""symbol_cols_min""symbol_cols_min":

  Mindestanzahl der Spalten des Symbols in Modulen.

  'symbol_cols_max'"symbol_cols_max""symbol_cols_max""symbol_cols_max""symbol_cols_max""symbol_cols_max":

  Höchstanzahl der Spalten des Symbols in Modulen.

  'symbol_rows_min'"symbol_rows_min""symbol_rows_min""symbol_rows_min""symbol_rows_min""symbol_rows_min":

  Mindestanzahl der Zeilen des Symbols in Modulen.

  'symbol_rows_max'"symbol_rows_max""symbol_rows_max""symbol_rows_max""symbol_rows_max""symbol_rows_max":

  Höchstanzahl der Zeilen des Symbols in Modulen.

Erscheinungsbild der Module im Bild:

• Alle 2D-Datacode-Modelle:

  'polarity'"polarity""polarity""polarity""polarity""polarity":

  Mögliche Einschränkungen hinsichtlich der Polarität der Module, d.h. ob diese im Bild dunkel vor hellem Hintergrund oder hell vor dunklem Hintergrund erscheinen: 'dark_on_light'"dark_on_light""dark_on_light""dark_on_light""dark_on_light""dark_on_light", 'light_on_dark'"light_on_dark""light_on_dark""light_on_dark""light_on_dark""light_on_dark" oder 'any'"any""any""any""any""any".

  'discard_undecoded_candidates'"discard_undecoded_candidates""discard_undecoded_candidates""discard_undecoded_candidates""discard_undecoded_candidates""discard_undecoded_candidates"

  Steuert, ob Kandidaten, die nicht erfolgreich dekodiert werden konnten, beim Modell gespeichert werden: 'yes'"yes""yes""yes""yes""yes", 'no'"no""no""no""no""no".

  'mirrored'"mirrored""mirrored""mirrored""mirrored""mirrored":

  Angabe über eine mögliche Spiegelung des Symbols (entspricht einem Vertauschen von Spalten und Zeilen): 'yes'"yes""yes""yes""yes""yes", 'no'"no""no""no""no""no" oder 'any'"any""any""any""any""any".

• Alle 2D-Datacode-Modelle bis auf Data Matrix ECC 200 und DotCode:

  'contrast_min'"contrast_min""contrast_min""contrast_min""contrast_min""contrast_min":

  Mindestkontrast zwischen Vorder- und Hintergrund des Symbols im Bild (angegeben in Grauwerten). Dieses Maß korrespondiert mit dem Anstieg der Kanten zwischen Vorder- und Hintergrund.

• Alle 2D-Datacode-Modelle bis auf PDF417:

  'module_size_min'"module_size_min""module_size_min""module_size_min""module_size_min""module_size_min":

  Minimale Größe der Module im Bild in Pixel.

  'module_size_max'"module_size_max""module_size_max""module_size_max""module_size_max""module_size_max":

  Maximale Größe der Module im Bild in Pixel.

  Es kann in drei Stufen angegeben werden, ob benachbarte Vordergrundmodule direkt aneinanderstoßen, oder ob es zwischen ihnen eine Lücke geben kann - 'no'"no""no""no""no""no" (keine Lücke) < 'small'"small""small""small""small""small" < 'big'"big""big""big""big""big" (Bei DotCode sind nur 'no'"no""no""no""no""no" und 'small'"small""small""small""small""small" möglich):

  'module_gap_min'"module_gap_min""module_gap_min""module_gap_min""module_gap_min""module_gap_min":

  minimale Lücke.

  'module_gap_max'"module_gap_max""module_gap_max""module_gap_max""module_gap_max""module_gap_max":

  maximale Lücke.

• Alle 2D-Datacode-Modelle bis auf DotCode:

  'small_modules_robustness'"small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness":

  Robustheit der Dekodierung gegenüber Datacodes mit sehr kleiner Modulgröße. Wird der Parameter 'small_modules_robustness'"small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness" auf 'high'"high""high""high""high""high" gesetzt, so erhöht sich die Wahrscheinlichkeit, dass Datacodes mit sehr kleinen Modulen dekodiert werden können. Zusätzlich sollte in diesem Fall auch die minimale Modulgröße entsprechend angepasst werden, d.h. 'module_size_min'"module_size_min""module_size_min""module_size_min""module_size_min""module_size_min" bzw. 'module_width_min'"module_width_min""module_width_min""module_width_min""module_width_min""module_width_min" (PDF417) sollte auf die angenommene minimale Modulgröße bzw. Modulbreite gesetzt werden. Ist 'small_modules_robustness'"small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness" auf 'high'"high""high""high""high""high" gesetzt, so kann sich der interne Speicherbedarf von find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d deutlich erhöhen. Folglich sollte 'small_modules_robustness'"small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness""small_modules_robustness" im Normalfall auf 'low'"low""low""low""low""low" gesetzt werden.

  Werteliste: 'low'"low""low""low""low""low", 'high'"high""high""high""high""high"

  Default: 'low'"low""low""low""low""low" (enhanced: 'low'"low""low""low""low""low", maximum: 'high'"high""high""high""high""high")

• PDF417:

  'module_width_min'"module_width_min""module_width_min""module_width_min""module_width_min""module_width_min":

  Minimale Breite der Module im Bild in Pixel.

  'module_width_max'"module_width_max""module_width_max""module_width_max""module_width_max""module_width_max":

  Maximale Breite der Module im Bild in Pixel.

  'module_aspect_min'"module_aspect_min""module_aspect_min""module_aspect_min""module_aspect_min""module_aspect_min":

  Minimales Seitenverhältnis der Module im Bild (Höhe zu Breite).

  'module_aspect_max'"module_aspect_max""module_aspect_max""module_aspect_max""module_aspect_max""module_aspect_max":

  Maximales Seitenverhältnis der Module im Bild (Höhe zu Breite).

• Aztec Code:

  'finder_pattern_tolerance'"finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance":

  Toleranz der Suche gegenüber einem gestörten oder teilweise fehlenden Finder-Pattern. Abhängig von diesem Parameter werden verschiedene Algorithmen für die Suche in find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d verwendet. Für 'low'"low""low""low""low""low" wird angenommen, dass alle Ringe des Finder-Patterns extrahiert werden können. Für 'high'"high""high""high""high""high" wird angenommen, dass mindestens einer der Ringe des Finder-Patterns extrahiert werden kann.

  'additional_levels'"additional_levels""additional_levels""additional_levels""additional_levels""additional_levels":

  Um die Robustheit des Aztec Code Lesers zu erhöhen, kann die Anzahl der Pyramidenebenen, die zusätzlich zu den durch die minimale und maximale Modulgröße bedingten Ebenen untersucht werden sollen, angegeben werden. [0..2]

• Data Matrix ECC 200:

  'slant_max'"slant_max""slant_max""slant_max""slant_max""slant_max":

  Maximale Abweichung des Winkels im L-förmigen Finder-Pattern vom (idealerweise) rechten Winkel (die Angabe erfolgt im Bogenmaß und korrespondiert mit der möglichen Verzerrung, die beim Druck des Symbols oder bei der Bildaufnahme auftreten kann).

  'finder_pattern_tolerance'"finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance":

  Toleranz der Suche gegenüber einem gestörten oder teilweise fehlenden Finder-Pattern. Das Finder-Pattern umschließt sowohl die L-förmige als auch die gegenüberliegende alternierende Seite. In Abhängigkeit von diesem Parameter werden verschiedene Algorithmen für die Suche in find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d verwendet. In einem Fall ('low'"low""low""low""low""low") wird davon ausgegangen, dass das Finder-Pattern zum großen Teil vorhanden ist und kaum Störungen aufweist. Im anderen Fall ('high'"high""high""high""high""high") kann das Finder-Pattern gestört oder teilweise fehlend sein, ohne dass die Erkennung beeinträchtigt wird. Zu beachten ist allerdings, dass bei dieser Variante die Parameter für die Symbolsuche möglichst stark mit set_data_code_2d_paramset_data_code_2d_paramSetDataCode2dParamSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param eingeschränkt werden sollten, da ansonsten eine erhöhte Rechenzeit für find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d zu erwarten ist. Zu beachten ist außerdem, dass sich beide Algorithmen leicht in ihrer Robustheit voneinander unterscheiden. Dies kann dazu führen, dass es selbst bei Symbolen mit intaktem Finder-Pattern in Abhängigkeit von 'finder_pattern_tolerance'"finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance" zu unterschiedlichen Ergebnissen kommt. Wenn 'high'"high""high""high""high""high" ausgewählt wird, können z.B. nur Symbole mit festem Gitter gefunden werden (siehe unten), wodurch die Robustheit gegenüber perspektivischen Verzerrungen abnimmt. Im Fall 'any'"any""any""any""any""any" werden beide Algorithmen ausgeführt.

  'module_grid'"module_grid""module_grid""module_grid""module_grid""module_grid":

  Angabe darüber, ob die Größe der Module in einem gewissen Rahmen variieren darf oder nicht. In Abhängigkeit von diesem Parameter werden verschiedene Algorithmen für die Berechnung der Modulpositionen verwendet. In einem Fall ('fixed'"fixed""fixed""fixed""fixed""fixed") wird ein festes Gitter, bei dem die Abstände zwischen den Modulmittelpunkten alle gleich sind, verwendet. Im anderen Fall ('variable'"variable""variable""variable""variable""variable") wird das Gitter an der alternierenden Seite des Finder-Patterns ausgerichtet. Bei 'any'"any""any""any""any""any" werden beide Varianten für das Gitter nacheinander ausprobiert. Zu beachten ist, dass der Wert von 'module_grid'"module_grid""module_grid""module_grid""module_grid""module_grid" ignoriert wird, wenn 'finder_pattern_tolerance'"finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance""finder_pattern_tolerance" auf 'high'"high""high""high""high""high" gesetzt ist. In diesem Fall wird immer von einem festen Gitter ausgegangen.

  'contrast_tolerance'"contrast_tolerance""contrast_tolerance""contrast_tolerance""contrast_tolerance""contrast_tolerance":

  Toleranz der Suche beim Auftreten starker lokaler Kontrastvariationen (z.B. bei Reflexionen oder Überbelichtung). Abhängig von diesem Parameter wird zwischen zwei Algorithmen gewählt. Im Falle von 'high'"high""high""high""high""high" ist die Robustheit gegenüber starken lokalen Kontrastvariationen erhöht. Für 'low'"low""low""low""low""low" wird ein Algorithmus gewählt, der zwar etwas weniger robust bei lokalen Kontrastvariationen ist, dafür aber schneller. Unter normalen Umständen ist daher 'low'"low""low""low""low""low" zu bevorzugen. Setzt man den Parameter auf 'any'"any""any""any""any""any", so werden beide Varianten ausgeführt.

• QR Code:

  'position_pattern_min'"position_pattern_min""position_pattern_min""position_pattern_min""position_pattern_min""position_pattern_min":

  Anzahl von Position-Detection-Patterns, die im Bild gut sichtbar sein müssen, damit ein Symbolkandidat generiert wird.

Allgemeines Modellverhalten:

• Alle 2D-Datacode-Modelle:

  'persistence'"persistence""persistence""persistence""persistence""persistence":

  Steuert, ob bestimmte Zwischenergebnisse bei der Symbolsuche mit find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d temporär oder persistent im Modell gespeichert werden sollen: 0 (temporär) oder 1 (persistent).

  'strict_model'"strict_model""strict_model""strict_model""strict_model""strict_model":

  Steuert das Verhalten von find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d bei der Detektion von Symbolen, die hinsichtlich der Symbolgröße nicht den Modellvorgaben entsprechen: 'yes'"yes""yes""yes""yes""yes" (strikt: entsprechende Symbole werden verworfen) oder 'no'"no""no""no""no""no" (nicht strikt: Symbole werden, wenn sie gelesen werden können, als Ergebnis zurückgeliefert). Es ist zu beachten, dass für DotCode-Symbole die Modellvorgaben bzgl. der Modulgröße ('module_size_min'"module_size_min""module_size_min""module_size_min""module_size_min""module_size_min" und 'module_size_max'"module_size_max""module_size_max""module_size_max""module_size_max""module_size_max") auch dann nicht überprüft werden, wenn 'strict_model'"strict_model""strict_model""strict_model""strict_model""strict_model" auf 'yes'"yes""yes""yes""yes""yes" gesetzt ist.

  'string_encoding'"string_encoding""string_encoding""string_encoding""string_encoding""string_encoding":

  Gibt die erwartete Zeichencodierung des im Symbol kodierten Strings: 'utf8'"utf8""utf8""utf8""utf8""utf8", 'locale'"locale""locale""locale""locale""locale", 'latin1'"latin1""latin1""latin1""latin1""latin1" oder 'raw'"raw""raw""raw""raw""raw".

  'symbol_type'"symbol_type""symbol_type""symbol_type""symbol_type""symbol_type":

  Gibt den beim Erzeugen mit create_data_code_2d_modelcreate_data_code_2d_modelCreateDataCode2dModelCreateDataCode2dModelCreateDataCode2dModelcreate_data_code_2d_model angegebenen Datacode-Typ zurück.

  'timeout'"timeout""timeout""timeout""timeout""timeout":

  Mit Hilfe dieses Parameters ist es möglich, dass find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d nach einer definierten Zeit in ms abbricht: 'false'"false""false""false""false""false", -1, 20 .. 100.

• Alle 2D-Datacode-Modelle bis auf Aztec Code:

  'strict_quiet_zone'"strict_quiet_zone""strict_quiet_zone""strict_quiet_zone""strict_quiet_zone""strict_quiet_zone":

  Steuert das Verhalten von find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d bei der Detektion von lesbaren Symbolen deren Ruhezone Defekte aufweist. Mögliche Werte:

  'yes'"yes""yes""yes""yes""yes":

  Symbole mit schlechten Bewertungen für ihre Ruhezone werden verworfen und somit nicht als Resultat zurückgegeben. Die Ruhezonen werden ähnlich der Druckbildkontrolle ausgewertet, dabei jedoch nur als ein Modul groß betrachtet. Verworfene Symbole erhalten als 'status'"status""status""status""status""status" den Wert 'quiet zone is missing'"quiet zone is missing""quiet zone is missing""quiet zone is missing""quiet zone is missing""quiet zone is missing".

  'no'"no""no""no""no""no" (Default):

  Alle lesbaren Symbole werden als Ergebnis zurückgegeben.

• Alle 2D-Datacode-Modelle bis auf DotCode:

  'quality_isoiec15415_aperture_size'"quality_isoiec15415_aperture_size""quality_isoiec15415_aperture_size""quality_isoiec15415_aperture_size""quality_isoiec15415_aperture_size""quality_isoiec15415_aperture_size":

  Definiert die simulierte Blendenöffnung für die Druckqualitätsprüfung nach ISO/IEC 15415:2011 als Anteil an der Modulgröße. (Siehe ISO/IEC 15415:2011 Abschnitt 7.3.3).

• Data Matrix ECC 200:

  'candidate_selection'"candidate_selection""candidate_selection""candidate_selection""candidate_selection""candidate_selection":

  Bestimmt die Auswahl der Kandidatenregionen, die verwendet werden, um Symbole im Bild zu finden. Wird dieser Parameter auf 'extensive'"extensive""extensive""extensive""extensive""extensive" gesetzt, so erhöht sich die Anzahl der generierten Kandidatenregionen und damit die Wahrscheinlichkeit einen Code zu finden. Wenn 'candidate_selection'"candidate_selection""candidate_selection""candidate_selection""candidate_selection""candidate_selection" auf 'default'"default""default""default""default""default" gesetzt ist, werden weniger Kandidatenregionen verwendet.

• DotCode:

  'candidate_selection'"candidate_selection""candidate_selection""candidate_selection""candidate_selection""candidate_selection":

  Bestimmt die Auswahl der Kandidatenregionen, die verwendet werden, um Symbole im Bild zu finden. Wird dieser Parameter auf 'extensive'"extensive""extensive""extensive""extensive""extensive" gesetzt, so erhöht sich die Anzahl der generierten Kandidatenregionen und damit die Wahrscheinlichkeit einen Code zu finden. Wird dieser Parameter auf 'all'"all""all""all""all""all" gesetzt, werden alle möglichen Kandidaten genutzt und nicht anhand ihrer Wahrscheinlichkeit ein DotCode zu sein gefiltert. Wenn 'candidate_selection'"candidate_selection""candidate_selection""candidate_selection""candidate_selection""candidate_selection" auf 'default'"default""default""default""default""default" gesetzt ist, werden weniger Kandidatenregionen verwendet.

  'max_allowed_error_correction'"max_allowed_error_correction""max_allowed_error_correction""max_allowed_error_correction""max_allowed_error_correction""max_allowed_error_correction":

  Bestimmt die maximal zulässige Fehlerkorrektur. Aufgrund der hohen Fehlerkorrekturkapazität, ist es möglich 'false positive' DotCode Kandidaten erfolgreich zu dekodieren. Besonders Kandidaten, die nur einen kleinen Teil eines echten DotCode-Symbols bedecken, werden aufgrund der Fehlerkorrektur eventuell erfolgreich dekodiert. Der Grund dafür ist, dass DotCode-Symbole so gut wie jede Größe annehmen können. Das macht es schwieriger falsche Kandidaten auszusortieren. Um diesem Problem entgegenzuwirken, kann der Parameter 'max_allowed_error_correction'"max_allowed_error_correction""max_allowed_error_correction""max_allowed_error_correction""max_allowed_error_correction""max_allowed_error_correction" verwendet werden, um anzugeben wie viel Prozent der Fehlerkorrekturkapazität genutzt werden dürfen. Standardmäßig ist der Wert auf '1.0'"1.0""1.0""1.0""1.0""1.0", also 100% gesetzt. Wird der Wert z.B. auf '0.5'"0.5""0.5""0.5""0.5""0.5" herabgesetzt, werden nur noch die Kandidaten als erfolgreich dekodierte Ergebnisse zurückgegeben, die mit maximal 50% genutzter Fehlerkorrektur dekodiert werden konnten.

Es ist möglich, in einem Operatoraufruf obige Parameter beliebig zu kombinieren und gemeinsam in einem Tupel an GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name zu übergeben. Als Ergebnis wird in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value ein Tupel gleicher Länge zurückgeliefert, dessen Werte mit den entsprechenden Parameternamen korrespondieren.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

get_data_code_2d_paramget_data_code_2d_paramGetDataCode2dParamGetDataCode2dParamGetDataCode2dParamget_data_code_2d_param liefert den Wert TRUE, falls die übergebenen Parameter korrekt sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

query_data_code_2d_paramsquery_data_code_2d_paramsQueryDataCode2dParamsQueryDataCode2dParamsQueryDataCode2dParamsquery_data_code_2d_params, set_data_code_2d_paramset_data_code_2d_paramSetDataCode2dParamSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param, find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d

Nachfolger

find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d, write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model

Alternativen

write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model

Siehe auch

query_data_code_2d_paramsquery_data_code_2d_paramsQueryDataCode2dParamsQueryDataCode2dParamsQueryDataCode2dParamsquery_data_code_2d_params, set_data_code_2d_paramset_data_code_2d_paramSetDataCode2dParamSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param, get_data_code_2d_resultsget_data_code_2d_resultsGetDataCode2dResultsGetDataCode2dResultsGetDataCode2dResultsget_data_code_2d_results, get_data_code_2d_objectsget_data_code_2d_objectsGetDataCode2dObjectsGetDataCode2dObjectsGetDataCode2dObjectsget_data_code_2d_objects, find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d

Modul

Data Code