concat_objconcat_objConcatObjConcatObjconcat_obj (Operator)

Name

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

Signatur

Beschreibung

concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj konkateniert die Objekttupel Objects1Objects1Objects1Objects1objects1objects_1 und Objects2Objects2Objects2Objects2objects2objects_2 zu einem neuen Tupel ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcatobjects_concat. Dieses enthält also alle ikonischen Objekte, die in den beiden Eingabelisten enthalten sind:

ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcatobjects_concat = [Objects1Objects1Objects1Objects1objects1objects_1,Objects2Objects2Objects2Objects2objects2objects_2]

In ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcatobjects_concat werden erst alle Objekte aus Objects1Objects1Objects1Objects1objects1objects_1 und dann die Objekte von Objects2Objects2Objects2Objects2objects2objects_2 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_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval, overpaint_grayoverpaint_grayOverpaintGrayOverpaintGrayOverpaintGrayoverpaint_gray oder overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region durchgeführt werden, auch die Bilder des Ausgabetupels ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcatobjects_concat betreffen und umgekehrt.

concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj 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_objConcatObjConcatObjConcatObjconcat_obj 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_objConcatObjConcatObjConcatObjconcat_obj, copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj, select_objselect_objSelectObjSelectObjSelectObjselect_obj und disp_objdisp_objDispObjDispObjDispObjdisp_obj sind.

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

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);
disp_region(CircleAndRectangle,WindowHandle);

Komplexität

Laufzeitkomplexität: O(|Objects1Objects1Objects1Objects1objects1objects_1| + |Objects2Objects2Objects2Objects2objects2objects_2|);

Speicherplatzkomplexität der Ergebnisdaten: O(|Objects1Objects1Objects1Objects1objects1objects_1| + |Objects2Objects2Objects2Objects2objects2objects_2|)

Ergebnis

Sind die Surrogate korrekt, d.h. alle Objekte in der HALCON-Datenbank vorhanden, dann liefert concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj 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>)set_system("no_object_result",<Result>) festlegen.

Siehe auch

count_objcount_objCountObjCountObjCountObjcount_obj, copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj, select_objselect_objSelectObjSelectObjSelectObjselect_obj, disp_objdisp_objDispObjDispObjDispObjdisp_obj

Modul

Foundation