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.
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)