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 2 (H_MSG_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.