Operator Reference

HALCON Operator Reference / Object / Manipulation
ClassesClasses | | Operators

obj_diffobj_diffObjDiffObjDiffobj_diff (Operator)

obj_diffobj_diffObjDiffObjDiffobj_diff — Calculate the difference of two object tuples.

Signature

obj_diff(Objects, ObjectsSub : ObjectsDiff : : )

Herror obj_diff(const Hobject Objects, const Hobject ObjectsSub, Hobject* ObjectsDiff)

Herror T_obj_diff(const Hobject Objects, const Hobject ObjectsSub, Hobject* ObjectsDiff)

void ObjDiff(const HObject& Objects, const HObject& ObjectsSub, HObject* ObjectsDiff)

HObject HObject::ObjDiff(const HObject& ObjectsSub) const

HImage HImage::ObjDiff(const HImage& ObjectsSub) const

HRegion HRegion::ObjDiff(const HRegion& ObjectsSub) const

HXLD HXLD::ObjDiff(const HXLD& ObjectsSub) const

HXLDCont HXLDCont::ObjDiff(const HXLDCont& ObjectsSub) const

HXLDPoly HXLDPoly::ObjDiff(const HXLDPoly& ObjectsSub) const

HXLDPara HXLDPara::ObjDiff(const HXLDPara& ObjectsSub) const

HXLDModPara HXLDModPara::ObjDiff(const HXLDModPara& ObjectsSub) const

HXLDExtPara HXLDExtPara::ObjDiff(const HXLDExtPara& ObjectsSub) const

def obj_diff(objects: HObject, objects_sub: HObject) -> HObject

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) → objectHObjectHObjectHObjectHobject

Object tuple 1.

ObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub (input_object)  object(-array) → objectHObjectHObjectHObjectHobject

Object tuple 2.

ObjectsDiffObjectsDiffObjectsDiffobjectsDiffobjects_diff (output_object)  object(-array) → objectHObjectHObjectHObjectHobject *

Objects from ObjectsObjectsObjectsobjectsobjects that are not part of ObjectsSubObjectsSubObjectsSubobjectsSubobjects_sub.

Result

obj_diffobj_diffObjDiffObjDiffobj_diff always returns 2 ( H_MSG_TRUE) .

See also

test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj, count_objcount_objCountObjCountObjcount_obj, copy_objcopy_objCopyObjCopyObjcopy_obj, select_objselect_objSelectObjSelectObjselect_obj

Module

Foundation

ClassesClasses | | Operators