copy_objcopy_objCopyObjcopy_objCopyObjCopyObj (Operator)

Name

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj — Kopieren von Bildobjekten in der HALCON-Datenbank.

Signatur

copy_obj(Objects : ObjectsSelected : Index, NumObj : )

Beschreibung

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj kopiert NumObjNumObjNumObjNumObjNumObjnumObj Bildobjekte ab Position IndexIndexIndexIndexIndexindex (beginnend mit 1) aus dem Tupel von Eingabeobjekten in ObjectsObjectsObjectsObjectsObjectsobjects. Das resultierende Tupel von Ausgabeobjekten wird in ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelected abgelegt. Wird für NumObjNumObjNumObjNumObjNumObjnumObj der Wert -1 verwendet, dann werden alle Objekte ab IndexIndexIndexIndexIndexindex kopiert. Beim Kopieren werden die Region und die Bilder nicht dupliziert. Es werden neue Objekte angelegt, die Verweise auf die Regionen und Bilder enthalten. Die Anzahl von Objekten in einem Tupel kann mit count_objcount_objCountObjcount_objCountObjCountObj abgefragt werden.

Die in HALCON verfügbaren ikonischen Objekte werden bei der Einleitung zu Kapitel Objekt vorgestellt.

Parallelisierung

Unterstützt Objekte auf Compute Devices.
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

ObjectsObjectsObjectsObjectsObjectsobjects (input_object) object(-array) → object

Objekte, die kopiert werden sollen.

ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelected (output_object) object(-array) → object

Kopierte Objekte.

IndexIndexIndexIndexIndexindex (input_control) integer → (integer)

Ab dieser Position in dem Tupel Object werden Bildobjekte kopiert.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000

Typischer Wertebereich: 1 ≤ Index Index Index Index Index index

Restriktion: Index <= number(Objects)

NumObjNumObjNumObjNumObjNumObjnumObj (input_control) integer → (integer)

Anzahl der zu kopierenden Bildobjekte oder -1.

Defaultwert: 1

Wertevorschläge: -1, 1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000

Typischer Wertebereich: -1 ≤ NumObj NumObj NumObj NumObj NumObj numObj

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

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

Beispiel (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);
}

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

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

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

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

Komplexität

Laufzeitkomplexität: O(|ObjectsObjectsObjectsObjectsObjectsobjects| + NumObjNumObjNumObjNumObjNumObjnumObj);

Speicherkomplexität der Ausgabedaten: O(NumObjNumObjNumObjNumObjNumObjnumObj)

Ergebnis

Sind die Surrogate korrekt, d.h. alle Objekte in der HALCON-Datenbank vorhanden und die Parameter korrekt, dann liefert copy_objcopy_objCopyObjcopy_objCopyObjCopyObj den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabeobjekte vorhanden) lässt sich mittels set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

count_objcount_objCountObjcount_objCountObjCountObj

Alternativen

select_objselect_objSelectObjselect_objSelectObjSelectObj

Siehe auch

count_objcount_objCountObjcount_objCountObjCountObj, concat_objconcat_objConcatObjconcat_objConcatObjConcatObj, obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger, copy_imagecopy_imageCopyImagecopy_imageCopyImageCopyImage

Modul

Foundation

Operatoren