integer_to_objinteger_to_objIntegerToObjIntegerToObjinteger_to_obj (Operator)
Name
integer_to_objinteger_to_objIntegerToObjIntegerToObjinteger_to_obj — Convert an “integer number” into an iconic object.
Signature
Description
integer_to_objinteger_to_objIntegerToObjIntegerToObjIntegerToObjinteger_to_obj is the inverse operator to
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer. All surrogates of objects passed in
SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple are stored as objects. In contrast to
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer, the objects are duplicated.
integer_to_objinteger_to_objIntegerToObjIntegerToObjIntegerToObjinteger_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
SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple, the program will crash because 0 is no
valid pointer.
For a short description of the iconic objects that are available in HALCON
see the introduction of chapter Object.
Attention
The objects are duplicated in the database.
Execution Information
- Supports objects on compute devices.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ObjectsObjectsObjectsObjectsobjectsobjects (output_object) object(-array) → objectHObjectHObjectHObjectHobject *
Created objects.
SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple (input_control) pointer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Tuple of object surrogates.
Result
integer_to_objinteger_to_objIntegerToObjIntegerToObjIntegerToObjinteger_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
set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>).
If necessary, an exception is raised.
See also
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer
Module
Foundation