test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region (Operator)
Name
test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegiontest_equal_region — Test whether the regions of two objects are identical.
Signature
Description
The operator test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegionTestEqualRegiontest_equal_region compares the regions of the
two input parameters. The n-th element in Regions1Regions1Regions1Regions1regions1regions_1 is
compared to the n-th object in Regions2Regions2Regions2Regions2regions2regions_2 (for all n). If
all regions are equal and the number of regions is identical the
operator IsEqualIsEqualIsEqualIsEqualisEqualis_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
Regions1Regions1Regions1Regions1regions1regions_1 (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Test regions.
Regions2Regions2Regions2Regions2regions2regions_2 (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Comparative regions.
Number of elements:
Regions1 == Regions2
IsEqualIsEqualIsEqualIsEqualisEqualis_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_regionTestEqualRegionTestEqualRegionTestEqualRegiontest_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>)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_regionTestEqualRegionTestEqualRegionTestEqualRegiontest_equal_region returns the value 2 (
H_MSG_TRUE)
Alternatives
intersectionintersectionIntersectionIntersectionIntersectionintersection,
complementcomplementComplementComplementComplementcomplement,
area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center
See also
test_equal_objtest_equal_objTestEqualObjTestEqualObjTestEqualObjtest_equal_obj
Module
Foundation