integer_to_obj — Convert an “integer number” into an iconic object.
integer_to_obj is the inverse operator to
obj_to_integer. All surrogates of objects passed in
SurrogateTuple are stored as objects. In contrast to
obj_to_integer, the objects are duplicated.
integer_to_obj is intended especially for use in
HALCON/C, because iconic objects and control parameters are treated
differently in C. Please note that if you pass the value 0 in
SurrogateTuple, the program will crash because 0 is no
For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.
The objects are duplicated in the database.
Tuple of object surrogates.
integer_to_obj returns TRUE if all parameters are
correct, i.e., if they are valid object keys. If the input is empty
the behavior can be set via
If necessary, an exception is raised.