copy_objcopy_objCopyObjCopyObjcopy_obj (算子名称)

名称

copy_objcopy_objCopyObjCopyObjcopy_obj — Copy an iconic object in the HALCON database.

参数签名

copy_obj(Objects : ObjectsSelected : Index, NumObj : )

描述

copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj copies NumObjNumObjNumObjNumObjnumObjnum_obj iconic objects beginning with index IndexIndexIndexIndexindexindex (starting with 1) from the iconic input object tuple ObjectsObjectsObjectsObjectsobjectsobjects to the output object ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelectedobjects_selected. If -1 is passed for NumObjNumObjNumObjNumObjnumObjnum_obj all objects beginning with IndexIndexIndexIndexindexindex are copied. No new storage is allocated for the regions and images. Instead, new objects containing references to the existing objects are created. The number of objects in an object tuple can be queried with the operator count_objcount_objCountObjCountObjCountObjcount_obj.

For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.

运行信息

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.

参数表

ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → object

Objects to be copied.

ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelectedobjects_selected (output_object) object(-array) → object

Copied objects.

IndexIndexIndexIndexindexindex (input_control) integer → (integer)

Starting index of the objects to be copied.

Default: 1

Suggested values: 1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000

Value range: 1 ≤ Index Index Index Index index index

Restriction: Index <= number(Objects)

NumObjNumObjNumObjNumObjnumObjnum_obj (input_control) integer → (integer)

Number of objects to be copied or -1.

Default: 1

Suggested values: -1, 1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000

Value range: -1 ≤ NumObj NumObj NumObj NumObj numObj num_obj

Restriction: NumObj + Index - 1 <= number(Objects) && NumObj != 0

例程 (HDevelop)

gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)

例程 (C)

/* Access all regions */

count_obj(Regions,&Num);
for (i=1; i<=Num; i++);
{
  copy_obj(Regions,&Single,i,1);
  T_get_region_polygon(Single,5.0,&Row,&Column);
  T_disp_polygon(WindowHandleTuple,Row,Column);
  destroy_tuple(Row);
  destroy_tuple(Column);
}

例程 (HDevelop)

gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)

例程 (HDevelop)

gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)

例程 (HDevelop)

gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)

Complexity

Runtime complexity: O(|ObjectsObjectsObjectsObjectsobjectsobjects| + NumObjNumObjNumObjNumObjnumObjnum_obj);

Memory complexity of the result object: O(NumObjNumObjNumObjNumObjnumObjnum_obj)

结果

copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj returns 2 ( H_MSG_TRUE) if all objects are contained in the HALCON database and all parameters are correct. 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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

可能的前置算子

count_objcount_objCountObjCountObjCountObjcount_obj

可替代算子

select_objselect_objSelectObjSelectObjSelectObjselect_obj

参考其它

count_objcount_objCountObjCountObjCountObjcount_obj, concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj, obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer, copy_imagecopy_imageCopyImageCopyImageCopyImagecopy_image

模块

Foundation

算子列表