concat_objconcat_objconcat_objConcatObjConcatObj (Operator)

Name

concat_objconcat_objconcat_objConcatObjConcatObj — Concatenate two iconic object tuples.

Signature

Description

concat_objconcat_objconcat_objConcatObjConcatObj concatenates the two tuples of iconic objects Objects1Objects1Objects1Objects1objects1 and Objects2Objects2Objects2Objects2objects2 into a new object tuple ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat. Hence, this tuple contains all the objects of the two input tuples:

ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat = [Objects1Objects1Objects1Objects1objects1,Objects2Objects2Objects2Objects2objects2]

In ObjectsConcatObjectsConcatObjectsConcatObjectsConcatobjectsConcat the objects of Objects1Objects1Objects1Objects1objects1 are stored first, followed by the objects of Objects2Objects2Objects2Objects2objects2. The order of the objects is preserved. As usual, only the objects are copied, and not the corresponding images and regions, i.e., no new memory is allocated. concat_objconcat_objconcat_objConcatObjConcatObj is designed especially for HALCON/C. In languages like C++ it is not needed.

concat_objconcat_objconcat_objConcatObjConcatObj should not be confused with union1union1union1Union1Union1 or union2union2union2Union2Union2, in which regions are merged, i.e., in which the number of objects is modified.

concat_objconcat_objconcat_objConcatObjConcatObj can be used to concatenate objects of different image object types (e.g., images and XLD contours) into a single object. This is only recommended if it is necessary to accumulate in a single object variable, for example, the results of an image processing sequence. It should be noted that the only operators that can handle such object tuples of mixed type are concat_objconcat_objconcat_objConcatObjConcatObj, copy_objcopy_objcopy_objCopyObjCopyObj, select_objselect_objselect_objSelectObjSelectObj, and disp_objdisp_objdisp_objDispObjDispObj. For technical reasons, object tuples of mixed type must not be created in HDevelop.

Parallelization

• 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

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

Complexity

Runtime complexity: O(|Objects1Objects1Objects1Objects1objects1| + |Objects2Objects2Objects2Objects2objects2|);

Memory complexity of the result objects: O(|Objects1Objects1Objects1Objects1objects1| + |Objects2Objects2Objects2Objects2objects2|)

Result

concat_objconcat_objconcat_objConcatObjConcatObj returns 2 (H_MSG_TRUE) if all objects are contained in the HALCON database. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

See also

count_objcount_objcount_objCountObjCountObj, copy_objcopy_objcopy_objCopyObjCopyObj, select_objselect_objselect_objSelectObjSelectObj, disp_objdisp_objdisp_objDispObjDispObj

Module

Foundation