test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegion (Operator)

Name

test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegion — Test whether the regions of two objects are identical.

Signature

test_equal_region(Regions1, Regions2 : : : IsEqual)

Herror test_equal_region(const Hobject Regions1, const Hobject Regions2, Hlong* IsEqual)

Herror T_test_equal_region(const Hobject Regions1, const Hobject Regions2, Htuple* IsEqual)

void TestEqualRegion(const HObject& Regions1, const HObject& Regions2, HTuple* IsEqual)

Hlong HRegion::TestEqualRegion(const HRegion& Regions2) const

static void HOperatorSet.TestEqualRegion(HObject regions1, HObject regions2, out HTuple isEqual)

int HRegion.TestEqualRegion(HRegion regions2)

Description

The operator test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegionTestEqualRegion compares the regions of the two input parameters. The n-th element in Regions1Regions1Regions1Regions1regions1 is compared to the n-th object in Regions2Regions2Regions2Regions2regions2 (for all n). If all regions are equal and the number of regions is identical the operator IsEqualIsEqualIsEqualIsEqualisEqual 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.

Execution Information

Parameters

Regions1Regions1Regions1Regions1regions1 (input_object)  region(-array) objectHRegionHRegionHobject

Test regions.

Regions2Regions2Regions2Regions2regions2 (input_object)  region(-array) objectHRegionHRegionHobject

Comparative regions.

Number of elements: Regions1 == Regions2

IsEqualIsEqualIsEqualIsEqualisEqual (output_control)  integer HTupleHTupleHtuple (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, O(sqrt(F)) if the result is FALSE.

Result

The operator test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegionTestEqualRegion 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>)SetSystem("no_object_result",<Result>). If the number of objects differs an exception is raised. Else test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegionTestEqualRegion returns the value 2 (H_MSG_TRUE)

Alternatives

intersectionintersectionIntersectionIntersectionIntersection, complementcomplementComplementComplementComplement, area_centerarea_centerAreaCenterAreaCenterAreaCenter

See also

test_equal_objtest_equal_objTestEqualObjTestEqualObjTestEqualObj

Module

Foundation