concat_objconcat_objConcatObjconcat_objConcatObjConcatObj (Operator)

Name

concat_objconcat_objConcatObjconcat_objConcatObjConcatObj — Konkatenieren von zwei Objekttupeln zu einem Tupel von Objekten.

Signatur

Beschreibung

concat_objconcat_objConcatObjconcat_objConcatObjConcatObj konkateniert die Objekttupel Objects1Objects1Objects1Objects1Objects1objects1 und Objects2Objects2Objects2Objects2Objects2objects2 zu einem neuen Tupel ObjectsConcatObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat. Dieses enthält also alle ikonischen Objekte, die in den beiden Eingabelisten enthalten sind:

ObjectsConcatObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat = [Objects1Objects1Objects1Objects1Objects1objects1,Objects2Objects2Objects2Objects2Objects2objects2]

In ObjectsConcatObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat werden erst alle Objekte aus Objects1Objects1Objects1Objects1Objects1objects1 und dann die Objekte von Objects2Objects2Objects2Objects2Objects2objects2 abgelegt. Die Reihenfolge der Objekte wird dabei nicht verändert. Zu beachten ist, dass dabei Referenzen auf die Bilder und Regionen angelegt werden, aber nicht die Bilder und Regionen selber kopiert werden. Das bedeutet, dass Änderungen an Eingabebildern, die z.B. mit set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval, overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray oder overpaint_regionoverpaint_regionOverpaintRegionoverpaint_regionOverpaintRegionOverpaintRegion durchgeführt werden, auch die Bilder des Ausgabetupels ObjectsConcatObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat betreffen und umgekehrt.

concat_objconcat_objConcatObjconcat_objConcatObjConcatObj ist nicht mit union1union1Union1union1Union1Union1 oder union2union2Union2union2Union2Union2 zu verwechseln, bei denen die Regionen vereinigt werden, also die Anzahl der Objekte verändert wird.

Mit concat_objconcat_objConcatObjconcat_objConcatObjConcatObj ist es möglich, Objekte verschiedener Bildobjekttypen (z.B. Bilder und XLD-Konturen) zu einem Objekt zu konkatenieren. Dies ist ausschließlich dann sinnvoll, wenn es unumgänglich ist, in einer Objektvariable z.B. alle Ergebnisse einer Bildverarbeitungssequenz aufzusammeln. Dabei ist zu beachten, dass die einzigen Operatoren, die diese Art von gemischten Objekttupeln verarbeiten können, concat_objconcat_objConcatObjconcat_objConcatObjConcatObj, copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, select_objselect_objSelectObjselect_objSelectObjSelectObj und disp_objdisp_objDispObjdisp_objDispObjDispObj sind.

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

Beispiel (C)

/* generate a tuple of a circle and a rectangle */

gen_circle(&Circle,200.0,400.0,23.0);
gen_rectangle1(&Rectangle,23.0,44.0,203.0,201.0);
concat_obj(Circle,Rectangle,&CirclAndRectangle);
clear_obj(Circle); clear_obj(Rectangle);
disp_region(CircleAndRectangle,WindowHandle);

Komplexität

Laufzeitkomplexität: O(|Objects1Objects1Objects1Objects1Objects1objects1| + |Objects2Objects2Objects2Objects2Objects2objects2|);

Speicherplatzkomplexität der Ergebnisdaten: O(|Objects1Objects1Objects1Objects1Objects1objects1| + |Objects2Objects2Objects2Objects2Objects2objects2|)

Ergebnis

Sind die Surrogate korrekt, d.h. alle Objekte in der HALCON-Datenbank vorhanden, dann liefert concat_objconcat_objConcatObjconcat_objConcatObjConcatObj 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.

Siehe auch

count_objcount_objCountObjcount_objCountObjCountObj, copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, select_objselect_objSelectObjselect_objSelectObjSelectObj, disp_objdisp_objDispObjdisp_objDispObjDispObj

Modul

Foundation