obj_diffobj_diffObjDiffObjDiff (Operator)

Name

obj_diffobj_diffObjDiffObjDiff — 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

static void HOperatorSet.ObjDiff(HObject objects, HObject objectsSub, out HObject objectsDiff)

HObject HObject.ObjDiff(HObject objectsSub)

HImage HImage.ObjDiff(HImage objectsSub)

HRegion HRegion.ObjDiff(HRegion objectsSub)

HXLD HXLD.ObjDiff(HXLD objectsSub)

HXLDCont HXLDCont.ObjDiff(HXLDCont objectsSub)

HXLDPoly HXLDPoly.ObjDiff(HXLDPoly objectsSub)

HXLDPara HXLDPara.ObjDiff(HXLDPara objectsSub)

HXLDModPara HXLDModPara.ObjDiff(HXLDModPara objectsSub)

HXLDExtPara HXLDExtPara.ObjDiff(HXLDExtPara objectsSub)

Description

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

Parameters

ObjectsObjectsObjectsObjectsobjects (input_object)  object(-array) objectHObjectHObjectHobject

Object tuple 1.

ObjectsSubObjectsSubObjectsSubObjectsSubobjectsSub (input_object)  object(-array) objectHObjectHObjectHobject

Object tuple 2.

ObjectsDiffObjectsDiffObjectsDiffObjectsDiffobjectsDiff (output_object)  object(-array) objectHObjectHObjectHobject *

Objects from ObjectsObjectsObjectsObjectsobjects that are not part of ObjectsSubObjectsSubObjectsSubObjectsSubobjectsSub.

Result

obj_diffobj_diffObjDiffObjDiffObjDiff always returns 2 (H_MSG_TRUE).

See also

test_equal_objtest_equal_objTestEqualObjTestEqualObjTestEqualObj, count_objcount_objCountObjCountObjCountObj, copy_objcopy_objCopyObjCopyObjCopyObj, select_objselect_objSelectObjSelectObjSelectObj

Module

Foundation