test_equal_region🔗
Short description🔗
test_equal_region — Test whether the regions of two objects are identical.
Signature🔗
test_equal_region( region Regions1, region Regions2, out integer IsEqual )
Description🔗
The operator test_equal_region compares the regions of the
two input parameters. The n-th element in Regions1 is
compared to the n-th object in Regions2 (for all n). If
all regions are equal and the number of regions is identical the
operator IsEqual 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🔗
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🔗
Regions1 (input_object) region(-array) → object
Test regions.
Regions2 (input_object) region(-array) → object
Comparative regions.
Number of elements: Regions1 == Regions2
IsEqual (output_control) integer → (integer)
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_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>:).
If the number of objects differs an exception is raised.
Else test_equal_region returns the value 2 (H_MSG_TRUE)
Combinations with other operators🔗
Module🔗
Foundation