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_diffObjDiffObjDiffObjDiffobj_diff calculates the set-theoretic difference of two object tuples: (objects in Objects) - (objects in ObjectsSub) The resulting object tuple ObjectsDiffObjectsDiffObjectsDiffObjectsDiffobjectsDiffobjects_diff is defined as the input tuple ObjectsObjectsObjectsObjectsobjectsobjects with all objects from ObjectsSubObjectsSubObjectsSubObjectsSubobjectsSubobjects_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

ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → object

Object tuple 1.

ObjectsSubObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub (input_object) object(-array) → object

Object tuple 2.

ObjectsDiffObjectsDiffObjectsDiffObjectsDiffobjectsDiffobjects_diff (output_object) object(-array) → object

Objects from ObjectsObjectsObjectsObjectsobjectsobjects that are not part of ObjectsSubObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub.

Result

obj_diffobj_diffObjDiffObjDiffObjDiffobj_diff always returns 2 (H_MSG_TRUE).

Module

Foundation

Operators