get_bar_code_paramT_get_bar_code_paramGetBarCodeParamGetBarCodeParam (Operator)
Name
get_bar_code_paramT_get_bar_code_paramGetBarCodeParamGetBarCodeParam
— Abfrage von einem oder mehreren Parameter, die das Barcode-Modell
beschreiben.
Signatur
Beschreibung
Mit Hilfe des Operators get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam
lassen sich die
Parameter, durch die das Barcode-Modell beschrieben wird und die für eine
erfolgreiche Suche und Dekodierung eines Barcodes benötigt werden,
abfragen.
Die Namen der Parameter, die abgefragt werden sollen, werden in
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
übergeben, die korrespondierenden Werte werden
in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
zurückgeliefert. Sämtliche Parameter
können mit set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam
gesetzt und jederzeit verändert
werden. Siehe auch dort für eine detaillierte Beschreibung der Bedeutung
der Parameter.
Einige Parameter können durch set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecific
oder
während des automatischen Parametertrainings spezifisch für einen Barcode-
Typ gesetzt werden. Diese Parameter können nicht mit
get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam
, sondern müssen mit
get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific
ausgelesen werden. Alle Parameter, die
in get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific
aufgelistet sind, können prinzipiell
spezifisch gesetzt sein. Welche Parameter
zur Laufzeit tatsächlich spezifisch gesetzt sind, kann mit dem Operator
query_bar_code_paramsquery_bar_code_paramsQueryBarCodeParamsQueryBarCodeParamsQueryBarCodeParams
bestimmt werden.
Im Einzelnen kann auf die folgenden Parameter - gruppiert nach
verschiedenen Kategorien - zugegriffen werden:
Größe der Barcode Elemente:
- 'element_size_min'"element_size_min""element_size_min""element_size_min""element_size_min":
-
Die minimale Größe eines Basiselements, d.h. die minimale Dicke der
schmalsten Striche und Zwischenräume des speziellen Barcodetyps.
- 'element_size_max'"element_size_max""element_size_max""element_size_max""element_size_max":
-
Die maximale Größe eines Basislements, d.h. die maximale Dicke der
schmalsten Striche und Zwischenräume des speziellen Barcodetyps.
- 'element_size_variable'"element_size_variable""element_size_variable""element_size_variable""element_size_variable":
-
Gibt an, ob die Größe eines Elements innerhalb eines Barcodes variiert.
- 'barcode_height_min'"barcode_height_min""barcode_height_min""barcode_height_min""barcode_height_min":
-
Die minimale Höhe des Barcodes.
- 'barcode_width_min'"barcode_width_min""barcode_width_min""barcode_width_min""barcode_width_min":
-
Die minimal Breite des Barcodes.
Scannen:
- 'num_scanlines'"num_scanlines""num_scanlines""num_scanlines""num_scanlines":
-
Maximale Anzahl von Scanlinien per Kandidatregion.
- 'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines":
-
Minimale Anzahl von Scanlinien, welche identische Ergebnisse liefern
müssen, damit die Dekodierung eines Symbols akzeptiert wird.
- 'majority_voting'"majority_voting""majority_voting""majority_voting""majority_voting":
-
Steuert das Verhalten bei der Auswahl unterschiedlicher Dekodierergebnisse
pro Scanlinie. Dieser Parameter spezifiziert ob ein Mehrheitsvotum
durchgeführt werden soll.
- 'stop_after_result_num'"stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num":
-
Anzahl erfolgreich dekodierter Barcodes nach der die Dekodierung
angehalten wird.
- 'orientation'"orientation""orientation""orientation""orientation":
-
Zugelassene Orientierung der dekodierten Barcodes.
- 'orientation_tol'"orientation_tol""orientation_tol""orientation_tol""orientation_tol":
-
Toleranz der zugelassenen Orientierung.
- 'quiet_zone'"quiet_zone""quiet_zone""quiet_zone""quiet_zone":
-
Verifikation der Ruhezonen.
- 'start_stop_tolerance'"start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance":
-
Toleranz des Matchingkriteriums zum Start-, bzw. Stopmuster.
- 'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length":
-
Minimale Anzahl dekodierter Zeichen.
- 'merge_scanlines'"merge_scanlines""merge_scanlines""merge_scanlines""merge_scanlines":
-
Steuert, ob vereinigte Scanlinie berechnet werden sollen, wenn
nicht genügend einzelne Scanlinien erfolgreich dekodiert werden
konnten. Somit können verdeckte oder beschädigte Barcodes gelesen
werden.
Erscheinungsbild des Barcodes:
- 'meas_thresh'"meas_thresh""meas_thresh""meas_thresh""meas_thresh":
-
Relativer Schwellwert zur Detektion von Kanten in der Barcode Region.
- 'meas_thresh_abs'"meas_thresh_abs""meas_thresh_abs""meas_thresh_abs""meas_thresh_abs":
-
Absoluter Schwellwert zur Detektion von Kanten in der Barcode Region.
- 'contrast_min'"contrast_min""contrast_min""contrast_min""contrast_min":
-
Minimaler Kontrast zwischen dem Vorder- und Hintergrund der
Barcode-Elemente.
Barcode spezifische Parameter:
- 'check_char'"check_char""check_char""check_char""check_char":
-
Berücksichtigung eines optionalen Prüfzeichens.
- 'composite_code'"composite_code""composite_code""composite_code""composite_code":
-
Vorhandensein und Typ eines an den Barcode angehängten
2D GS1-Composite Code.
- 'upce_encodation'"upce_encodation""upce_encodation""upce_encodation""upce_encodation":
-
Ausgabeformat für UPC-E-Barcodes.
Sonstiges:
- 'timeout'"timeout""timeout""timeout""timeout":
-
Vorzeitiger Abbruch von find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCode
bei Zeitüberschreitung.
- 'persistence'"persistence""persistence""persistence""persistence":
-
Steuert, ob bestimmte Zwischenergebnisse bei der Symbolsuche mit
find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCode
temporär oder persistent im Modell gespeichert
werden sollen.
- 'train'"train""train""train""train":
Gibt die Namen der momentan trainierten Parameter zurück. Das
zurückgelieferte Tupel kann anschließend als GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
an get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam
übergeben werden, um die
trainierten Werte der trainierten Parameter zu bekommen.
Für weitere Erklärungen, siehe set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam
.
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
BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle
(input_control) barcode →
HBarCode, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des zu verwendenden Barcode-Modells.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
(input_control) attribute.name(-array) →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Namen der generischen Parameter, die für den
Barcode abgefragt werden sollen.
Defaultwert:
'element_size_min'
"element_size_min"
"element_size_min"
"element_size_min"
"element_size_min"
Werteliste: 'barcode_height_min'"barcode_height_min""barcode_height_min""barcode_height_min""barcode_height_min", 'barcode_width_min'"barcode_width_min""barcode_width_min""barcode_width_min""barcode_width_min", 'check_char'"check_char""check_char""check_char""check_char", 'composite_code'"composite_code""composite_code""composite_code""composite_code", 'contrast_min'"contrast_min""contrast_min""contrast_min""contrast_min", 'element_size_max'"element_size_max""element_size_max""element_size_max""element_size_max", 'element_size_min'"element_size_min""element_size_min""element_size_min""element_size_min", 'element_size_variable'"element_size_variable""element_size_variable""element_size_variable""element_size_variable", 'majority_voting'"majority_voting""majority_voting""majority_voting""majority_voting", 'meas_thresh'"meas_thresh""meas_thresh""meas_thresh""meas_thresh", 'meas_thresh_abs'"meas_thresh_abs""meas_thresh_abs""meas_thresh_abs""meas_thresh_abs", 'merge_scanlines'"merge_scanlines""merge_scanlines""merge_scanlines""merge_scanlines", 'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length", 'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines", 'num_scanlines'"num_scanlines""num_scanlines""num_scanlines""num_scanlines", 'orientation'"orientation""orientation""orientation""orientation", 'orientation_tol'"orientation_tol""orientation_tol""orientation_tol""orientation_tol", 'persistence'"persistence""persistence""persistence""persistence", 'quiet_zone'"quiet_zone""quiet_zone""quiet_zone""quiet_zone", 'start_stop_tolerance'"start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance", 'stop_after_result_num'"stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num", 'timeout'"timeout""timeout""timeout""timeout", 'train'"train""train""train""train", 'upce_encodation'"upce_encodation""upce_encodation""upce_encodation""upce_encodation"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
(output_control) attribute.name(-array) →
HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Werte der generischen Parameter.
Ergebnis
get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam
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_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModel
,
set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam
Nachfolger
set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam
Alternativen
get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific
Modul
Bar Code