test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegiontest_subset_region (Operator)
Name
test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegiontest_subset_region — Test whether a region is contained in another region.
Signature
Description
test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegionTestSubsetRegiontest_subset_region tests whether Region1Region1Region1Region1region1region_1 is a
subset of Region2Region2Region2Region2region2region_2 and returns the result in
IsSubsetIsSubsetIsSubsetIsSubsetisSubsetis_subset. If more than one region should be tested,
Region1Region1Region1Region1region1region_1 and Region2Region2Region2Region2region2region_2 must have the same number of
elements. In this case, a tuple that contains as many elements as
Region1Region1Region1Region1region1region_1 and Region2Region2Region2Region2region2region_2 is returned in
IsSubsetIsSubsetIsSubsetIsSubsetisSubsetis_subset.
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).
- Automatically parallelized on tuple level.
Parameters
Region1Region1Region1Region1region1region_1 (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Test region.
Region2Region2Region2Region2region2region_2 (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Region for comparison.
Number of elements: Region1 == Region2
Result
test_subset_regiontest_subset_regionTestSubsetRegionTestSubsetRegionTestSubsetRegiontest_subset_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.
Alternatives
differencedifferenceDifferenceDifferenceDifferencedifference,
area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center
See also
test_equal_regiontest_equal_regionTestEqualRegionTestEqualRegionTestEqualRegiontest_equal_region,
compare_objcompare_objCompareObjCompareObjCompareObjcompare_obj
Module
Foundation