test_equal_obj — Compare image objects regarding equality.
The operator test_equal_obj compares the regions and gray value
components of all objects of the two input parameters.
The n-th object in Objects1 is compared to the n-th
object in Objects2 (for all n). If all corresponding
regions are equal and the number of regions is also identical the
parameter 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.
Image matrices and XLDs are not compared regarding their contents. Thus,
two images or XLDs, respectively, are “equal” if they are located at
the same place in the storage.
By contrast, regions that are not located at the same place in the
storage are compared regarding their actual contents.
If the input parameters are empty and the behavior was set via the operator
set_system(::'no_object_result','true':), the parameter
IsEqual is set to TRUE, since all input (= empty set) is equal.
Objects1 (input_object) object-array → object
Test objects.
Objects2 (input_object) object-array → object
Comparative objects.
IsEqual (output_control) integer → (integer)
Boolean result value.
If F is the area of a region the runtime complexity is O(1) or O(sqrt(F)) if the result is TRUE and O(sqrt(F)) if the result is FALSE.
The operator test_equal_obj 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_obj returns 2 (
H_MSG_TRUE)
compare_obj,
test_equal_region
Foundation