Operator Reference

HALCON Operator Reference / Object / Manipulation
ClassesClasses | | Operators

integer_to_objinteger_to_objIntegerToObjIntegerToObjinteger_to_obj (Operator)

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

Signature

integer_to_obj( : Objects : SurrogateTuple : )

Herror integer_to_obj(Hobject* Objects, const Hlong SurrogateTuple)

Herror T_integer_to_obj(Hobject* Objects, const Htuple SurrogateTuple)

void IntegerToObj(HObject* Objects, const HTuple& SurrogateTuple)

void HObject::IntegerToObj(const HTuple& SurrogateTuple)

void HObject::IntegerToObj(void* SurrogateTuple)

static void HOperatorSet.IntegerToObj(out HObject objects, HTuple surrogateTuple)

void HObject.IntegerToObj(HTuple surrogateTuple)

void HObject.IntegerToObj(IntPtr surrogateTuple)

def integer_to_obj(surrogate_tuple: MaybeSequence[int]) -> HObject

Description

integer_to_objinteger_to_objIntegerToObjIntegerToObjinteger_to_obj is the inverse operator to obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer. All surrogates of objects passed in SurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple are stored as objects. In contrast to obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer, the objects are duplicated. integer_to_objinteger_to_objIntegerToObjIntegerToObjinteger_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 SurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_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

ObjectsObjectsObjectsobjectsobjects (output_object)  object(-array) → objectHObjectHObjectHObjectHobject *

Created objects.

SurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple (input_control)  pointer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Tuple of object surrogates.

Result

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

See also

obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer

Module

Foundation

ClassesClasses | | Operators