insert_objinsert_objInsertObjInsertObjinsert_obj (Operator)
Name
insert_objinsert_objInsertObjInsertObjinsert_obj — 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_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