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(F) if the result is TRUE and O(F) if the result is FALSE.

The operator ::test_equal_obj returns the value H_MSG_TRUE if both object tuples are identical. If the tuples differ in at least one place ::test_equal_obj returns 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_region

bool

Basic operators