get_operator_info
— Get information concerning a HALCON-operator.
get_operator_info( : : OperatorName, Slot : Information)
With the help of the operator get_operator_info
the
online-texts concerning a certain operator can be called (see also
get_operator_name
). The form of information available for
all operators (Slot
) can be called using the operator
query_operator_info
. For the time being the following slots
are available:
Short description of the operator.
Description of the operator.
Name(s) of the chapter(s) in the operator hierarchy (chapter, subchapter in the HALCON manual).
Functionality is equivalent to the object class to which the operator can be assigned.
Keywords of the operator (optional).
Example for the use of the operator (optional). The operator 'example.LANGUAGE' calls up examples for a certain language if available. If the language is not indicated or if no example is available in this language, the TRIAS-example will be returned.
Complexity of the operator (optional).
Not in use so far.
Characteristic parallel behavior of an operator.
Method of automatic operator parallelization.
Modes of interruption the operator can deal with. See
set_operator_timeout
and interrupt_operator
on how to use and set these interrupt modes.
Alternative operators (optional).
Operators containing further information (optional).
Possible and sensible predecessor
Possible and sensible successor
Return value of the operator (TRUE, FALSE, FAIL, VOID or EXCEPTION).
Restrictions and advice concering the correct use of the operator (optional).
Names of the parameter of the operator (see also
get_param_info
).
Literary references (optional).
The module to which the operator is assigned.
The directory where the HTML documentation of the operator resides.
Possible warnings for using the operator.
List of compute devices supported by the operator.
The texts will be taken from the files operators_[LANG].ref,
operators_[LANG].sta, operators_[LANG].key, operators_[LANG].num and
operators_[LANG].idx which will be searched by HALCON in the currently used
directory or in the directory 'help_dir' (respectively 'user_help_dir') (see
also get_system
and set_system
). By adding '.latex' after
the slotname, the text of slots containing textual information can be made
available in LaTeX notation.
The encoding of the result is ISO 8859-1 for English and German, and UTF-8 for Japanese.
OperatorName
(input_control) proc_name →
(string)
Name of the operator on which more information is needed.
Default value: 'get_operator_info'
Slot
(input_control) string →
(string)
Desired information.
Default value: 'abstract'
List of values: '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 (empty if no information is available)
The operator get_operator_info
returns the value 2 (H_MSG_TRUE) if the
parameters are correct and the helpfiles are availabe. Otherwise an
exception is raised.
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