test_subset_regiontest_subset_regionTestSubsetRegiontest_subset_regionTestSubsetRegionTestSubsetRegion (Operator)

Name

test_subset_regiontest_subset_regionTestSubsetRegiontest_subset_regionTestSubsetRegionTestSubsetRegion — Test whether a region is contained in another region.

Signature

test_subset_region(Region1, Region2 : : : IsSubset)

Description

test_subset_regiontest_subset_regionTestSubsetRegiontest_subset_regionTestSubsetRegionTestSubsetRegion tests whether Region1Region1Region1Region1Region1region1 is a subset of Region2Region2Region2Region2Region2region2 and returns the result in IsSubsetIsSubsetIsSubsetIsSubsetIsSubsetisSubset. If more than one region should be tested, Region1Region1Region1Region1Region1region1 and Region2Region2Region2Region2Region2region2 must have the same number of elements. In this case, a tuple that contains as many elements as Region1Region1Region1Region1Region1region1 and Region2Region2Region2Region2Region2region2 is returned in IsSubsetIsSubsetIsSubsetIsSubsetIsSubsetisSubset.

For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.

Parallelization

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

Region1Region1Region1Region1Region1region1 (input_object) region(-array) → object

Test region.

Region2Region2Region2Region2Region2region2 (input_object) region(-array) → object

Region for comparison.

Number of elements: Region1 == Region2

IsSubsetIsSubsetIsSubsetIsSubsetIsSubsetisSubset (output_control) integer(-array) → (integer)

Is Region1Region1Region1Region1Region1region1 contained in Region2Region2Region2Region2Region2region2?

Result

test_subset_regiontest_subset_regionTestSubsetRegiontest_subset_regionTestSubsetRegionTestSubsetRegion 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If the number of objects differs an exception is raised.

Alternatives

differencedifferenceDifferencedifferenceDifferenceDifference, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter

Module

Foundation

Operators