Operator Reference

HALCON Operator Reference / Regions / Tests
ClassesClasses | | Operators

test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region (Operator)

test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region — 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)

def test_equal_region(regions_1: HObject, regions_2: HObject) -> int

Description

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

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

Regions1Regions1Regions1regions1regions_1 (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Test regions.

Regions2Regions2Regions2regions2regions_2 (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Comparative regions.

Number of elements: Regions1 == Regions2

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

Result

The operator test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region 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_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region returns the value 2 ( H_MSG_TRUE)

Alternatives

intersectionintersectionIntersectionIntersectionintersection, complementcomplementComplementComplementcomplement, area_centerarea_centerAreaCenterAreaCenterarea_center

See also

test_equal_objtest_equal_objTestEqualObjTestEqualObjtest_equal_obj

Module

Foundation

ClassesClasses | | Operators