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 operator test_equal_obj returns the value TRUE, otherwise FALSE.

Image matrices are not compared regarding their contents. Thus, two images are ``equal'' if they are at the same place in the store. If the input parameters are empty and the behavior was set via the operator set_system(::'no_object_result','true':), the operator test_equal_obj returns TRUE, since all input (= empty set) is equal.

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 both object tuples are identical. If the tuples differ in at least one place test_equal_obj returns 3 (H_MSG_FALSE). 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.

test_equal_obj is reentrant and processed without parallelization.

test_equal_region

bool

Basic operators