get_operator_info
— Informationen zu einem HALCON-Operator.
get_operator_info( : : OperatorName, Slot : Information)
get_operator_info
dient zur Abfrage der Online-Texte zu
einem vorgegebenen Operator (siehe auch
get_operator_name
). Die Art der Information
(Slot
), die für jeden Operator zur Verfügung stehen,
lassen sich mittels query_operator_info
abfragen. Derzeit werden folgende Slots angeboten:
Kurzbeschreibung des Operators.
Beschreibung des Operators.
Kapitelname(n) in der Operatorhierarchie (Kapitel, Unterkapitel im HALCON-Manual).
Funktionalität, ist gleich der Objektklasse, der der Operator zugeordnet werden kann.
Schlüsselwörter zu dem Operator (optional).
Beispiel für die Anwendung des Operators (optional). Mit 'example.SPRACHE' (SPRACHE) können Beispiele für eine bestimmte Sprache abgefragt werden, insofern sie vorhanden sind. Wird die Sprache nicht mit angegeben oder ist in dieser Sprache kein Beispiel vorhandenen, wird das TRIAS-Beispiel ausgegeben.
Komplexität des Operators (optional).
Momentan nicht genutzt.
Charakteristik des parallelen Verhaltens eines Operators.
Methoden der von einem Operator unterstützten automatischen Parallelisierung.
Modi der Unterbrechbarkeit, die von einem spezifischen Operator unterstützt werden. In der Dokumentation von set_operator_timeout
und interrupt_operator
ist beschrieben, wie diese Modi genutzt und gesetzt werden können.
Alternativen zum Operator (optional).
Operatoren mit weitergehenden Informationen (optional).
Mögliche und sinnvolle Vorgängerprozedur
Mögliche und sinnvolle Nachfolgerprozedur
Rückgabewert des Operators (TRUE, FALSE, FAIL, VOID oder EXCEPTION).
Einschränkungen und Hinweise zur korrekten Anwendung des Operators (optional).
Namen der Parameter des Operators (siehe get_param_info
).
Literaturverweise (optional).
Das Modul, zu dem der Operator gehört.
Das Verzeichnis, in dem die HTML-Dokumentation des Operators steht.
Eventuelle Warnungen zur Verwendung des Operators.
Liste von Compute Devices, die vom Operator unterstützt werden.
Die 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_system
und set_system
) sucht. Bei Slots mit
textuellen Informationen kann mit '.latex' nach dem Slotnamen der Text in
LaTeX Notation geholt werden.
Das Encoding der Ergebnisse ist ISO 8859-1 für Englisch und Deutsch sowie UTF-8 für Japanisch.
OperatorName
(input_control) proc_name →
(string)
Name des Operators, zu dem Information benötigt werden.
Defaultwert: 'get_operator_info'
Slot
(input_control) string →
(string)
Gewünschte Information.
Defaultwert: 'abstract'
Werteliste: 'abstract' , 'alternatives' , 'attention' , 'chapter' , 'chapter_id' , 'complexity' , 'compute_device' , 'example' , 'functionality' , 'html_path' , 'interrupt_mode' , 'keywords' , 'module' , 'parallel_method' , 'parallelization' , 'parameter' , 'predecessor' , 'references' , 'result_state' , 'see_also' , 'short' , 'successor' , 'warning'
Information
(output_control) string(-array) →
(string)
Information (leer, falls keine Information vorhanden ist)
get_operator_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.
get_keywords
,
search_operator
,
get_operator_name
,
query_operator_info
,
query_param_info
,
get_param_info
get_param_names
,
get_param_num
,
get_param_types
query_operator_info
,
get_param_info
,
get_operator_name
,
get_param_num
,
get_param_types
Foundation