insert_objinsert_objInsertObjInsertObj (Operator)
Name
insert_objinsert_objInsertObjInsertObj — Insert objects into an iconic object tuple.
Signature
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)
Description
insert_objinsert_objInsertObjInsertObjInsertObj inserts the elements of ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert at
IndexIndexIndexIndexindex into the object tuple ObjectsObjectsObjectsObjectsobjects and returns the
result in ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtended.
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 ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtended is the sum of the length of ObjectsObjectsObjectsObjectsobjects
and ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert.
It is allowed to mix images, regions and XLDs in ObjectsObjectsObjectsObjectsobjects and
ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert.
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) → objectHObjectHObjectHobject
Input object tuple.
ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert (input_object) object(-array) → objectHObjectHObjectHobject
Object tuple to insert.
ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtended (output_object) object(-array) → objectHObjectHObjectHobject *
Extended object tuple.
IndexIndexIndexIndexindex (input_control) number → HTupleHTupleHtuple (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| + |ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert|).
Possible Predecessors
count_objcount_objCountObjCountObjCountObj
Possible Successors
count_objcount_objCountObjCountObjCountObj
Alternatives
concat_objconcat_objConcatObjConcatObjConcatObj
See also
count_objcount_objCountObjCountObjCountObj,
select_objselect_objSelectObjSelectObjSelectObj,
copy_objcopy_objCopyObjCopyObjCopyObj,
remove_objremove_objRemoveObjRemoveObjRemoveObj
Module
Foundation