Operator Reference

HALCON Operator Reference / Object / Manipulation

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

insert_objinsert_objInsertObjInsertObjinsert_obj (Operator)

insert_objinsert_objInsertObjInsertObjinsert_obj — Insert objects into an iconic object tuple.

Signature

insert_obj(Objects, ObjectsInsert : ObjectsExtended : Index : )

Herror insert_obj(const Hobject Objects, const Hobject ObjectsInsert, Hobject* ObjectsExtended, const Hlong Index)

Herror T_insert_obj(const Hobject Objects, const Hobject ObjectsInsert, Hobject* ObjectsExtended, const Htuple Index)

void InsertObj(const HObject& Objects, const HObject& ObjectsInsert, HObject* ObjectsExtended, const HTuple& Index)

HObject HObject::InsertObj(const HObject& ObjectsInsert, Hlong Index) const

HImage HImage::InsertObj(const HImage& ObjectsInsert, Hlong Index) const

HRegion HRegion::InsertObj(const HRegion& ObjectsInsert, Hlong Index) const

HXLD HXLD::InsertObj(const HXLD& ObjectsInsert, Hlong Index) const

HXLDCont HXLDCont::InsertObj(const HXLDCont& ObjectsInsert, Hlong Index) const

HXLDPoly HXLDPoly::InsertObj(const HXLDPoly& ObjectsInsert, Hlong Index) const

HXLDPara HXLDPara::InsertObj(const HXLDPara& ObjectsInsert, Hlong Index) const

HXLDModPara HXLDModPara::InsertObj(const HXLDModPara& ObjectsInsert, Hlong Index) const

HXLDExtPara HXLDExtPara::InsertObj(const HXLDExtPara& ObjectsInsert, Hlong Index) const

static void HOperatorSet.InsertObj(HObject objects, HObject objectsInsert, out HObject objectsExtended, HTuple index)

HObject HObject.InsertObj(HObject objectsInsert, int index)

HImage HImage.InsertObj(HImage objectsInsert, int index)

HRegion HRegion.InsertObj(HRegion objectsInsert, int index)

HXLD HXLD.InsertObj(HXLD objectsInsert, int index)

HXLDCont HXLDCont.InsertObj(HXLDCont objectsInsert, int index)

HXLDPoly HXLDPoly.InsertObj(HXLDPoly objectsInsert, int index)

HXLDPara HXLDPara.InsertObj(HXLDPara objectsInsert, int index)

HXLDModPara HXLDModPara.InsertObj(HXLDModPara objectsInsert, int index)

HXLDExtPara HXLDExtPara.InsertObj(HXLDExtPara objectsInsert, int index)

def insert_obj(objects: HObject, objects_insert: HObject, index: int) -> HObject

Description

insert_objinsert_objInsertObjInsertObjinsert_obj inserts the elements of ObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert at IndexIndexIndexindexindex into the object tuple ObjectsObjectsObjectsobjectsobjects and returns the result in ObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtendedobjects_extended.

IndexIndexIndexindexindex must contain a single integer value. Note that, in contrast to control tuples, indices of object tuple elements start at 1. The length of ObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtendedobjects_extended is the sum of the length of ObjectsObjectsObjectsobjectsobjects and ObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert. It is allowed to mix images, regions and XLDs in ObjectsObjectsObjectsobjectsobjects and ObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

ObjectsObjectsObjectsobjectsobjects (input_object)  object(-array) → objectHObjectHObjectHObjectHobject

Input object tuple.

ObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert (input_object)  object(-array) → objectHObjectHObjectHObjectHobject

Object tuple to insert.

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

Extended object tuple.

IndexIndexIndexindexindex (input_control)  number → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index to insert objects.

Example (HDevelop)

gen_image_const (Image1, 'byte', 1, 1)
gen_image_const (Image3, 'byte', 3, 3)
concat_obj (Image1, Image3, Images)
gen_image_const (Image, 'byte', 2, 2)
insert_obj (Images, Image, Images, 2)

Complexity

Typical runtime complexity: O(|ObjectsObjectsObjectsobjectsobjects| + |ObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert|).

Possible Predecessors

count_objcount_objCountObjCountObjcount_obj

Possible Successors

count_objcount_objCountObjCountObjcount_obj

Alternatives

concat_objconcat_objConcatObjConcatObjconcat_obj

See also

count_objcount_objCountObjCountObjcount_obj, select_objselect_objSelectObjSelectObjselect_obj, copy_objcopy_objCopyObjCopyObjcopy_obj, remove_objremove_objRemoveObjRemoveObjremove_obj

Module

Foundation

---

ClassesClasses | | Operators