HALCON Website / HALCON Operator-Referenz / System / Information
KlassenKlassen | | Operatoren

get_param_infoget_param_infoGetParamInfoGetParamInfoget_param_info (Operator)

Name

get_param_infoget_param_infoGetParamInfoGetParamInfoget_param_info — Informationen zu Operatorparametern.

Signatur

get_param_info( : : OperatorName, ParamName, Slot : Information)

Herror get_param_info(const char* OperatorName, const char* ParamName, const char* Slot, char* Information)

Herror T_get_param_info(const Htuple OperatorName, const Htuple ParamName, const Htuple Slot, Htuple* Information)

void GetParamInfo(const HTuple& OperatorName, const HTuple& ParamName, const HTuple& Slot, HTuple* Information)

static HTuple HInfo::GetParamInfo(const HString& OperatorName, const HString& ParamName, const HString& Slot)

static HTuple HInfo::GetParamInfo(const char* OperatorName, const char* ParamName, const char* Slot)

static HTuple HInfo::GetParamInfo(const wchar_t* OperatorName, const wchar_t* ParamName, const wchar_t* Slot)   (Nur Windows)

static void HOperatorSet.GetParamInfo(HTuple operatorName, HTuple paramName, HTuple slot, out HTuple information)

static HTuple HInfo.GetParamInfo(string operatorName, string paramName, string slot)

def get_param_info(operator_name: str, param_name: str, slot: str) -> Sequence[str]

def get_param_info_s(operator_name: str, param_name: str, slot: str) -> str

Beschreibung

get_param_infoget_param_infoGetParamInfoGetParamInfoGetParamInfoget_param_info dient zur Abfrage der Online-Texte zu einem Parameter eines vorgegebenen Operators. Die Art der Information (SlotSlotSlotSlotslotslot), die für jeden Parameter zur Verfügung steht, lässt sich mittels query_param_infoquery_param_infoQueryParamInfoQueryParamInfoQueryParamInfoquery_param_info abfragen. Mögliche Slots sind unten gelistet. Für eine detailliertere Beschreibung der Einträge wird auf das Manual „Extension Package Programmer’s Manual“ verwiesen.

'description'"description""description""description""description""description":

Beschreibung des Parameters.

'parameter_class'"parameter_class""parameter_class""parameter_class""parameter_class""parameter_class":

Parameterklasse.

'input_object'"input_object""input_object""input_object""input_object""input_object"

'output_object'"output_object""output_object""output_object""output_object""output_object"

'input_control'"input_control""input_control""input_control""input_control""input_control"

'output_control'"output_control""output_control""output_control""output_control""output_control"

'type_list'"type_list""type_list""type_list""type_list""type_list":

Zulässige(r) Datentyp(en) für Parameterwerte.

'default_type'"default_type""default_type""default_type""default_type""default_type":

Defaulttyp für Parameterwerte (nur bei Steuerparametern). Dies ist der Parametertyp der bei HALCON/C im „simple Mode“ verwendet wird. Falls 'none'"none""none""none""none""none" angegeben wird, dann muss der „Tupel Modus“ verwendet werden.

'sem_type'"sem_type""sem_type""sem_type""sem_type""sem_type":

Semantischer Typ des Parameters. Das ist wichtig für die Zuordnung der Parameter zu Objektklassen in objektorientierten Sprachen (C++, .NET, COM). Gehören mehrere Parameter semantisch zu einem Typ, so wird dies dabei ebenfalls bezeichnet.

'default_value'"default_value""default_value""default_value""default_value""default_value":

Defaultwert für den Parameter (nur bei Eingabe-Steuerparametern). Hierbei handelt es sich um eine reine Information (der Parameterwert muss in jedem Fall explizit übergeben werden, auch wenn der Defaultwert verwendet werden soll). Dieser Eintrag dient nur als Hinweis, als Ausgangspunkt für eigene Experimente. Die Werte sind so gewählt, dass sie normalerweise keine Fehler verursachen und etwas sinnvolles bewirken.

'modified'"modified""modified""modified""modified""modified":

'true'"true""true""true""true""true", falls der Operator den Eingabeparameter modifiziert.

'multivalue'"multivalue""multivalue""multivalue""multivalue""multivalue":

'true'"true""true""true""true""true", falls ein Tupel an Werten übergeben werden muss,

'false'"false""false""false""false""false", falls genau ein Wert übergeben werden muss, und

'optional'"optional""optional""optional""optional""optional", wenn beides erlaubt ist.

'multichannel'"multichannel""multichannel""multichannel""multichannel""multichannel":

'true'"true""true""true""true""true", falls ein Eingabebildobjekt mehrkanalig sein darf.

'multiinstance'"multiinstance""multiinstance""multiinstance""multiinstance""multiinstance":

'true'"true""true""true""true""true", falls ein Array semantischer Tupel (z.B. Posen, Kameraparameter, etc.) übergeben werden muss,

'false'"false""false""false""false""false", falls genau ein semantisches Tupel übergeben werden muss, und

'optional'"optional""optional""optional""optional""optional", wenn beides erlaubt ist.

'mixed_type'"mixed_type""mixed_type""mixed_type""mixed_type""mixed_type":

Nur bei Steuerparametern und auch nur dann, wenn Wertetupel ('multivalue'"multivalue""multivalue""multivalue""multivalue""multivalue"-'true'"true""true""true""true""true"/'optional'"optional""optional""optional""optional""optional") und verschiedene Datentypen für Parameterwerte ('type_list' mehr als ein Wert) zulässig sind. In diesem Fall gibt SlotSlotSlotSlotslotslot an, ob in einem Tupel auch Werte verschiedener Typen gemischt auftreten dürfen ('true'"true""true""true""true""true" oder 'false'"false""false""false""false""false").

'values'"values""values""values""values""values":

Werteauswahl (optional).

'value_list'"value_list""value_list""value_list""value_list""value_list":

Falls ein Parameter nur eine begrenzte Anzahl von Werten annehmen kann, werden diese explizit aufgeführt (optional).

'valuemin'"valuemin""valuemin""valuemin""valuemin""valuemin":

Minimalwert eines Werteintervalls.

'valuemax'"valuemax""valuemax""valuemax""valuemax""valuemax":

Maximalwert eines Werteintervalls.

'valuefunction'"valuefunction""valuefunction""valuefunction""valuefunction""valuefunction":

Funktion des Werteverlaufs einer Testreihe (lin, log, quadr, ...).

'steprec'"steprec""steprec""steprec""steprec""steprec":

Empfohlene Schrittweite der Parameterwerte in einer Testreihe.

'stepmin'"stepmin""stepmin""stepmin""stepmin""stepmin":

Minimale Schrittweite der Parameterwerte in einer Testreihe.

'valuenumber'"valuenumber""valuenumber""valuenumber""valuenumber""valuenumber":

Aussage über die Anzahl der Parameter absolut oder relativ zu anderen Parametern

'assertion'"assertion""assertion""assertion""assertion""assertion":

Aussage über die Parameterwerte absolut oder relativ zu anderen Parametern.

'cd_type_list.[compute_device]':

Liste der Eingabebild-Typen, die von der angegebenen Compute-Device-Implementierung des Operators unterstützt werden (z.B. 'cd_type_list.opencl' für OpenCL-Geräte).

'cd_value_list.[compute_device]':

Liste der Eingabe-Steuerparameter, die von der angegebenen Compute-Device-Implementierung des Operators unterstützt werden (z.B. 'cd_value_list.opencl' für OpenCL-Geräte).

Die Online-Texte werden den Dateien operators_[LANG].ref, operators_[LANG].sta, operators_[LANG].key, operators_[LANG].num und operators_[LANG].idx entnommen, die HALCON im aktuellen Verzeichnis und im Verzeichnis 'help_dir' (siehe get_systemget_systemGetSystemGetSystemGetSystemget_system und set_systemset_systemSetSystemSetSystemSetSystemset_system) sucht.

Achtung

Das Encoding der Ergebnisse ist UTF-8.

Ausführungsinformationen

Parameter

OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name (input_control)  proc_name → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name des Operators, zu dessen Parametern Information benötigt wird.

Defaultwert: 'get_param_info' "get_param_info" "get_param_info" "get_param_info" "get_param_info" "get_param_info"

ParamNameParamNameParamNameParamNameparamNameparam_name (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name des Parameters, zu dem Information benötigt wird.

Defaultwert: 'Slot' "Slot" "Slot" "Slot" "Slot" "Slot"

SlotSlotSlotSlotslotslot (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Gewünschte Information.

Defaultwert: 'description' "description" "description" "description" "description" "description"

Werteliste: 'assertion'"assertion""assertion""assertion""assertion""assertion", 'cd_type_list.opencl'"cd_type_list.opencl""cd_type_list.opencl""cd_type_list.opencl""cd_type_list.opencl""cd_type_list.opencl", 'cd_value_list.opencl'"cd_value_list.opencl""cd_value_list.opencl""cd_value_list.opencl""cd_value_list.opencl""cd_value_list.opencl", 'default_type'"default_type""default_type""default_type""default_type""default_type", 'default_value'"default_value""default_value""default_value""default_value""default_value", 'description'"description""description""description""description""description", 'mixed_type'"mixed_type""mixed_type""mixed_type""mixed_type""mixed_type", 'modified'"modified""modified""modified""modified""modified", 'multichannel'"multichannel""multichannel""multichannel""multichannel""multichannel", 'multivalue'"multivalue""multivalue""multivalue""multivalue""multivalue", 'sem_type'"sem_type""sem_type""sem_type""sem_type""sem_type", 'step_min'"step_min""step_min""step_min""step_min""step_min", 'step_rec'"step_rec""step_rec""step_rec""step_rec""step_rec", 'type_list'"type_list""type_list""type_list""type_list""type_list", 'value_function'"value_function""value_function""value_function""value_function""value_function", 'value_list'"value_list""value_list""value_list""value_list""value_list", 'value_max'"value_max""value_max""value_max""value_max""value_max", 'value_min'"value_min""value_min""value_min""value_min""value_min", 'value_number'"value_number""value_number""value_number""value_number""value_number", 'values'"values""values""values""values""values"

InformationInformationInformationInformationinformationinformation (output_control)  string(-array) → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Information (leer, falls keine Informationen vorhanden sind).

Ergebnis

get_param_infoget_param_infoGetParamInfoGetParamInfoGetParamInfoget_param_info liefert den Wert 2 (H_MSG_TRUE), wenn die Parameter korrekt sind und die Hilfsdateien verfügbar sind. Sonst wird eine Fehlerbehandlung durchgeführt.

Vorgänger

get_keywordsget_keywordsGetKeywordsGetKeywordsGetKeywordsget_keywords, search_operatorsearch_operatorSearchOperatorSearchOperatorSearchOperatorsearch_operator

Alternativen

get_param_namesget_param_namesGetParamNamesGetParamNamesGetParamNamesget_param_names, get_param_numget_param_numGetParamNumGetParamNumGetParamNumget_param_num, get_param_typesget_param_typesGetParamTypesGetParamTypesGetParamTypesget_param_types

Siehe auch

query_param_infoquery_param_infoQueryParamInfoQueryParamInfoQueryParamInfoquery_param_info, get_operator_infoget_operator_infoGetOperatorInfoGetOperatorInfoGetOperatorInfoget_operator_info, get_operator_nameget_operator_nameGetOperatorNameGetOperatorNameGetOperatorNameget_operator_name

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 22.11.4.0 Copyright © 1996-2025 MVTec Software GmbH
Follow us on