query_bar_code_paramsT_query_bar_code_paramsQueryBarCodeParamsQueryBarCodeParams (Operator)

Name

query_bar_code_paramsT_query_bar_code_paramsQueryBarCodeParamsQueryBarCodeParams — Liefert für das übergebene Barcode-Modell die Namen der Parameter, die in den set_bar_code*- und get_bar_code*-Operatoren benutzt werden können.

Signatur

query_bar_code_params( : : BarCodeHandle, Properties : GenParamName)

Herror T_query_bar_code_params(const Htuple BarCodeHandle, const Htuple Properties, Htuple* GenParamName)

void QueryBarCodeParams(const HTuple& BarCodeHandle, const HTuple& Properties, HTuple* GenParamName)

HTuple HBarCode::QueryBarCodeParams(const HString& Properties) const

HTuple HBarCode::QueryBarCodeParams(const char* Properties) const

HTuple HBarCode::QueryBarCodeParams(const wchar_t* Properties) const   (Nur Windows)

static void HOperatorSet.QueryBarCodeParams(HTuple barCodeHandle, HTuple properties, out HTuple genParamName)

HTuple HBarCode.QueryBarCodeParams(string properties)

Beschreibung

Mit Hilfe des Operators query_bar_code_paramsquery_bar_code_paramsQueryBarCodeParamsQueryBarCodeParamsQueryBarCodeParams lassen sich die Namen der Parameter des Barcode-Modells finden, die die Eigenschaften erfüllen, die in PropertiesPropertiesPropertiesPropertiesproperties angegeben sind. Um das zu erklären, hier einige Hintergrundinformationen. Nach Erstellen eines Barcode-Modells sind zuerst alle Parameter 'general'"general""general""general""general", d.h. sie haben die selben Werte für alle unterstützten Barcode-Typen gesetzt. Während des automatischen Parametertrainings oder nach Aufruf des Operators set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecific können einige Parameter zur Laufzeit barcodetyp-spezifisch werden. Diese Parameter können nicht mit dem allgemeinen Operator get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam ausgelesen werden, sondern nur mit get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific. Um dieses Auslesen einfach und generisch zu machen, kann die Ausgabe GenParamNameGenParamNameGenParamNameGenParamNamegenParamName von query_bar_code_paramsquery_bar_code_paramsQueryBarCodeParamsQueryBarCodeParamsQueryBarCodeParams als Eingabeparameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamName in get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam oder get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific verwendet werden, abhängig davon, ob PropertiesPropertiesPropertiesPropertiesproperties='*general'"*general""*general""*general""*general" oder PropertiesPropertiesPropertiesPropertiesproperties='*specific'"*specific""*specific""*specific""*specific".

Bitte beachten Sie, dass Sie alternativ ein statisches Tupel von Parameternamen in get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam oder get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific verwenden könnten, z.B. die in der Beschreibung angegebenen. Dieses Vorgehen ist jedoch unflexibel und wird nicht empfohlen.

Mögliche Werte für PropertiesPropertiesPropertiesPropertiesproperties sind:

'all'"all""all""all""all":

Alle vom Barcode-Leser unterstützten Parameternamen werden zurückgegeben. Die Namen sind unabhängig vom, durch BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle angegebenen, Barcode-Modell.

'general'"general""general""general""general":

Rückgabe der Namen derjenigen Parameter, die für alle unterstützten Barcode-Typen gleiche Werte gesetzt haben. Nur diese Parameter können mit get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam ausgelesen werden.

Der Parametername 'train' wird ausgeschlossen, weil dieser nicht zusammen mit anderen möglichen Parameternamen an get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam übergeben werden kann, da durch 'train' als Parameter für get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam mehrwertige Tupel zurückgegeben werden können.

'specific'"specific""specific""specific""specific":

Rückgabe der Namen derjenigen Parameter, die spezifisch für bestimmte Barcode-Typen gesetzt sind. Die Werte dieser Parameter müssen über get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific statt get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam ausgelesen werden. Barcodetyp-spezifische Werte können in Zusammenhang mit der Barcode-Autodiskriminierung auftreten die bei dem Operator find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCode erklärt wird oder beim automatischen Parametertraining.

'trained_general'"trained_general""trained_general""trained_general""trained_general":

Rückgabe der Namen derjenigen Parameter die bereits trainiert wurden und die für alle unterstützten Barcode-Typen gleiche Werte gesetzt haben. Der Trainingmodus ist bei dem Operator set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam beschrieben.

'trained_specific'"trained_specific""trained_specific""trained_specific""trained_specific":

Rückgabe der Namen derjenigen Parameter die bereits trainiert wurden und die spezifisch für bestimmte Barcode-Typen gesetzt sind. Der Trainingmodus ist bei dem Operator set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam beschrieben.

Ausführungsinformationen

Parameter

BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle (input_control)  barcode HBarCode, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des zu verwendenden Barcode-Modells.

PropertiesPropertiesPropertiesPropertiesproperties (input_control)  attribute.name HTupleHTupleHtuple (string) (string) (HString) (char*)

Eigenschaften der Paramter.

Defaultwert: 'trained_general' "trained_general" "trained_general" "trained_general" "trained_general"

Werteliste: 'all'"all""all""all""all", 'general'"general""general""general""general", 'specific'"specific""specific""specific""specific", 'trained_general'"trained_general""trained_general""trained_general""trained_general", 'trained_specific'"trained_specific""trained_specific""trained_specific""trained_specific"

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (output_control)  attribute.name(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Namen der generischen Parameter.

Beispiel (HDevelop)

TrainParams := ['element_size_min', 'element_size_max', 'orientation']
Train3times := gen_tuple_const(|TrainParams|,'train')
create_bar_code_model (Train3times, TrainParams, BarCodeHandle)
find_bar_code (Image, SymbolRegions, BarCodeHandle, 'EAN-13', \
               DecodedDataStrings)
query_bar_code_params (BarCodeHandle, 'trained_general', NamesGen)
* returns NamesGen = ['element_size_max', 'element_size_min']
get_bar_code_param (BarCodeHandle, NamesGen, ValGen)
* returns e.g. ValGen = [4.0, 1.5]
query_bar_code_params (BarCodeHandle, 'trained_specific', NamesSpec)
* returns NamesSpec = ['orientation', 'orientation_tol']
get_bar_code_param_specific (BarCodeHandle, 'EAN-13', NamesSpec, ValSpec)
* returns e.g. ValSpec = [89.9127, 0.5]

Ergebnis

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

Vorgänger

find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCode, decode_bar_code_rectangle2decode_bar_code_rectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2DecodeBarCodeRectangle2

Nachfolger

get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParam, get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecific

Modul

Bar Code