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

get_bar_code_param( : : BarCodeHandle, GenParamName : GenParamValue)

Herror T_get_bar_code_param(const Htuple BarCodeHandle, const Htuple GenParamName, Htuple* GenParamValue)

void GetBarCodeParam(const HTuple& BarCodeHandle, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HBarCode::GetBarCodeParam(const HTuple& GenParamName) const

HTuple HBarCode::GetBarCodeParam(const HString& GenParamName) const

HTuple HBarCode::GetBarCodeParam(const char* GenParamName) const

HTuple HBarCode::GetBarCodeParam(const wchar_t* GenParamName) const   (Nur Windows)

static void HOperatorSet.GetBarCodeParam(HTuple barCodeHandle, HTuple genParamName, out HTuple genParamValue)

HTuple HBarCode.GetBarCodeParam(HTuple genParamName)

HTuple HBarCode.GetBarCodeParam(string genParamName)

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

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