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_objInsertObjInsertObjInsertObjinsert_obj inserts the elements of ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert at
IndexIndexIndexIndexindexindex into the object tuple ObjectsObjectsObjectsObjectsobjectsobjects and returns the
result in ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtendedobjects_extended.
IndexIndexIndexIndexindexindex must contain a single integer value. Note that, in contrast
to control tuples, indices of object tuple elements start at 1. The length
of ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtendedobjects_extended is the sum of the length of ObjectsObjectsObjectsObjectsobjectsobjects
and ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert.
It is allowed to mix images, regions and XLDs in ObjectsObjectsObjectsObjectsobjectsobjects and
ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_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
ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → objectHObjectHObjectHObjectHobject
Input object tuple.
ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert (input_object) object(-array) → objectHObjectHObjectHObjectHobject
Object tuple to insert.
ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtendedobjects_extended (output_object) object(-array) → objectHObjectHObjectHObjectHobject *
Extended object tuple.
IndexIndexIndexIndexindexindex (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(|ObjectsObjectsObjectsObjectsobjectsobjects| + |ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsertobjects_insert|).
Possible Predecessors
count_objcount_objCountObjCountObjCountObjcount_obj
Possible Successors
count_objcount_objCountObjCountObjCountObjcount_obj
Alternatives
concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj
See also
count_objcount_objCountObjCountObjCountObjcount_obj,
select_objselect_objSelectObjSelectObjSelectObjselect_obj,
copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj,
remove_objremove_objRemoveObjRemoveObjRemoveObjremove_obj
Module
Foundation