obj_diffobj_diffObjDiffObjDiffobj_diff (Operator)

Name

obj_diffobj_diffObjDiffObjDiffobj_diff — Calculate the difference of two object tuples.

Signature

obj_diff(Objects, ObjectsSub : ObjectsDiff : : )

Description

obj_diffobj_diffObjDiffObjDiffobj_diff calculates the set-theoretic difference of two object tuples: (objects in Objects) - (objects in ObjectsSub) The resulting object tuple ObjectsDiffObjectsDiffObjectsDiffobjectsDiffobjects_diff is defined as the input tuple ObjectsObjectsObjectsobjectsobjects with all objects from ObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub removed.

For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.

Attention

Image matrices and XLDs are not compared regarding their contents. Thus, two images or XLDs, respectively, are “equal” if they are located at the same place in the storage. By contrast, regions that are not located at the same place in the storage are compared regarding their actual contents.

Execution Information

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

ObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → object

Object tuple 1.

ObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub (input_object) object(-array) → object

Object tuple 2.

ObjectsDiffObjectsDiffObjectsDiffobjectsDiffobjects_diff (output_object) object(-array) → object

Objects from ObjectsObjectsObjectsobjectsobjects that are not part of ObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub.

Result

obj_diffobj_diffObjDiffObjDiffobj_diff always returns 2 ( H_MSG_TRUE) .

Module

Foundation

Operators