copy_objcopy_objCopyObjCopyObj (Operator)

Name

copy_objcopy_objCopyObjCopyObj — Copy an iconic object in the HALCON database.

Signature

copy_obj(Objects : ObjectsSelected : Index, NumObj : )

Description

copy_objcopy_objCopyObjCopyObjCopyObj copies NumObjNumObjNumObjNumObjnumObj iconic objects beginning with index IndexIndexIndexIndexindex (starting with 1) from the iconic input object tuple ObjectsObjectsObjectsObjectsobjects to the output object ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelected. If -1 is passed for NumObjNumObjNumObjNumObjnumObj all objects beginning with IndexIndexIndexIndexindex 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_objCountObjCountObjCountObj.

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

Execution Information

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.

Parameters

ObjectsObjectsObjectsObjectsobjects (input_object) object(-array) → object

Objects to be copied.

ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelected (output_object) object(-array) → object

Copied objects.

IndexIndexIndexIndexindex (input_control) integer → (integer)

Starting index of the objects to be copied.

Default value: 1

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

Typical range of values: 1 ≤ Index Index Index Index index

Restriction: Index <= number(Objects)

NumObjNumObjNumObjNumObjnumObj (input_control) integer → (integer)

Number of objects to be copied or -1.

Default value: 1

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

Typical range of values: -1 ≤ NumObj NumObj NumObj NumObj numObj

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

Example (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)

Example (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);
  clear_obj(Single);
}

Example (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)

Example (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)

Example (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(|ObjectsObjectsObjectsObjectsobjects| + NumObjNumObjNumObjNumObjnumObj);

Memory complexity of the result object: O(NumObjNumObjNumObjNumObjnumObj)

Result

copy_objcopy_objCopyObjCopyObjCopyObj 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>). If necessary, an exception is raised.

Possible Predecessors

count_objcount_objCountObjCountObjCountObj

Alternatives

select_objselect_objSelectObjSelectObjSelectObj

Module

Foundation

Operators