obj_diffObjDiffObjDiffobj_diffobj_diff

HALCON ScriptCpp++.NETPythonC

Short description

obj_diffObjDiffObjDiffobj_diffobj_diff — Calculate the difference of two object tuples.

Signature

obj_diff( object Objects, object ObjectsSub, out object ObjectsDiff )void ObjDiff( const HObject& Objects, const HObject& ObjectsSub, HObject* ObjectsDiff )static void HOperatorSet.ObjDiff( HObject objects, HObject objectsSub, out HObject objectsDiff )def obj_diff( objects: HObject, objects_sub: HObject ) -> HObject

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

Herror T_obj_diff( 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

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

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

Objectsobjectsobjects (input_object) object(-array) → objectHObjectHObjectHObjectHobject

Object tuple 1.

ObjectsSubobjectsSubobjects_sub (input_object) object(-array) → objectHObjectHObjectHObjectHobject

Object tuple 2.

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

Objects from Objectsobjectsobjects that are not part of ObjectsSubobjectsSubobjects_sub.

Result

obj_diffObjDiff always returns 2 (H_MSG_TRUE).

Combinations with other operators

Combinations

See also

test_equal_objTestEqualObj, count_objCountObj, copy_objCopyObj, select_objSelectObj

Module

Foundation