integer_to_objinteger_to_objIntegerToObjinteger_to_objIntegerToObjIntegerToObj (Operator)

Name

integer_to_objinteger_to_objIntegerToObjinteger_to_objIntegerToObjIntegerToObj — Convert an “integer number” into an iconic object.

Signature

integer_to_obj( : Objects : SurrogateTuple : )

Description

integer_to_objinteger_to_objIntegerToObjinteger_to_objIntegerToObjIntegerToObj is the inverse operator to obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger. All surrogates of objects passed in SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple are stored as objects. In contrast to obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger, the objects are duplicated. integer_to_objinteger_to_objIntegerToObjinteger_to_objIntegerToObjIntegerToObj 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 SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple, 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.

Parallelization

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) → object

Created objects.

SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple (input_control) pointer(-array) → (integer)

Tuple of object surrogates.

Result

integer_to_objinteger_to_objIntegerToObjinteger_to_objIntegerToObjIntegerToObj 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

See also

obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger

Module

Foundation