Operator Reference

HALCON Operator Reference / Object / Information
ClassesClasses | | Operators

test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj (Operator)

test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj — Compare image objects regarding equality.

Signature

test_equal_obj(Objects1, Objects2 : : : IsEqual)

Herror test_equal_obj(const Hobject Objects1, const Hobject Objects2, Hlong* IsEqual)

Herror T_test_equal_obj(const Hobject Objects1, const Hobject Objects2, Htuple* IsEqual)

void TestEqualObj(const HObject& Objects1, const HObject& Objects2, HTuple* IsEqual)

Hlong HObject::TestEqualObj(const HObject& Objects2) const

Hlong HImage::TestEqualObj(const HImage& Objects2) const

Hlong HRegion::TestEqualObj(const HRegion& Objects2) const

Hlong HXLD::TestEqualObj(const HXLD& Objects2) const

Hlong HXLDCont::TestEqualObj(const HXLDCont& Objects2) const

Hlong HXLDPoly::TestEqualObj(const HXLDPoly& Objects2) const

Hlong HXLDPara::TestEqualObj(const HXLDPara& Objects2) const

Hlong HXLDModPara::TestEqualObj(const HXLDModPara& Objects2) const

Hlong HXLDExtPara::TestEqualObj(const HXLDExtPara& Objects2) const

static void HOperatorSet.TestEqualObj(HObject objects1, HObject objects2, out HTuple isEqual)

int HObject.TestEqualObj(HObject objects2)

int HImage.TestEqualObj(HImage objects2)

int HRegion.TestEqualObj(HRegion objects2)

int HXLD.TestEqualObj(HXLD objects2)

int HXLDCont.TestEqualObj(HXLDCont objects2)

int HXLDPoly.TestEqualObj(HXLDPoly objects2)

int HXLDPara.TestEqualObj(HXLDPara objects2)

int HXLDModPara.TestEqualObj(HXLDModPara objects2)

int HXLDExtPara.TestEqualObj(HXLDExtPara objects2)

def test_equal_obj(objects_1: HObject, objects_2: HObject) -> int

Description

The operator test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj compares the regions and gray value components of all objects of the two input parameters. The n-th object in Objects1Objects1Objects1objects1objects_1 is compared to the n-th object in Objects2Objects2Objects2objects2objects_2 (for all n). If all corresponding regions are equal and the number of regions is also identical the parameter IsEqualIsEqualIsEqualisEqualis_equal is set to TRUE, otherwise FALSE.

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. If the input parameters are empty and the behavior was set via the operator set_system(::'no_object_result','true':)set_system("no_object_result","true")SetSystem("no_object_result","true")SetSystem("no_object_result","true")set_system("no_object_result","true"), the parameter IsEqualIsEqualIsEqualisEqualis_equal is set to TRUE, since all input (= empty set) is equal.

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

Objects1Objects1Objects1objects1objects_1 (input_object)  object-array → objectHObjectHObjectHObjectHobject

Test objects.

Objects2Objects2Objects2objects2objects_2 (input_object)  object-array → objectHObjectHObjectHObjectHobject

Comparative objects.

IsEqualIsEqualIsEqualisEqualis_equal (output_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Boolean result value.

Complexity

If F is the area of a region the runtime complexity is O(1) or O(sqrt(F)) if the result is TRUE and O(sqrt(F)) if the result is FALSE.

Result

The operator test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj returns the value 2 ( H_MSG_TRUE) if the parameters are correct. The behavior in case of empty input (no input objects available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If the number of objects differs an exception is raised. Else test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj returns 2 ( H_MSG_TRUE)

See also

compare_objcompare_objCompareObjCompareObjcompare_obj, test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region

Module

Foundation

ClassesClasses | | Operators