copy_objcopy_objCopyObjCopyObj (Operator)

Name

copy_objcopy_objCopyObjCopyObj — Kopieren von Bildobjekten in der HALCON-Datenbank.

Signatur

copy_obj(Objects : ObjectsSelected : Index, NumObj : )

Beschreibung

copy_objcopy_objCopyObjCopyObjCopyObj kopiert NumObjNumObjNumObjNumObjnumObj Bildobjekte ab Position IndexIndexIndexIndexindex (beginnend mit 1) aus dem Tupel von Eingabeobjekten in ObjectsObjectsObjectsObjectsobjects. Das resultierende Tupel von Ausgabeobjekten wird in ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelected abgelegt. Wird für NumObjNumObjNumObjNumObjnumObj der Wert -1 verwendet, dann werden alle Objekte ab IndexIndexIndexIndexindex 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_objCountObjCountObjCountObj abgefragt werden.

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

Ausführungsinformationen

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

ObjectsObjectsObjectsObjectsobjects (input_object) object(-array) → object

Objekte, die kopiert werden sollen.

ObjectsSelectedObjectsSelectedObjectsSelectedObjectsSelectedobjectsSelected (output_object) object(-array) → object

Kopierte Objekte.

IndexIndexIndexIndexindex (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

Restriktion: Index <= number(Objects)

NumObjNumObjNumObjNumObjnumObj (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

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)

Komplexität

Laufzeitkomplexität: O(|ObjectsObjectsObjectsObjectsobjects| + NumObjNumObjNumObjNumObjnumObj);

Speicherkomplexität der Ausgabedaten: O(NumObjNumObjNumObjNumObjnumObj)

Ergebnis

Sind die Surrogate korrekt, d.h. alle Objekte in der HALCON-Datenbank vorhanden und die Parameter korrekt, dann liefert copy_objcopy_objCopyObjCopyObjCopyObj 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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

count_objcount_objCountObjCountObjCountObj

Alternativen

select_objselect_objSelectObjSelectObjSelectObj

Siehe auch

count_objcount_objCountObjCountObjCountObj, concat_objconcat_objConcatObjConcatObjConcatObj, obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToInteger, copy_imagecopy_imageCopyImageCopyImageCopyImage

Modul

Foundation

Operatoren