equal_obj ( Objects1, Objects2 : : : )

Compare image objects regarding equality.

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


Attention

Image matrices are not compared with regard to 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 equal_obj returns TRUE, since all input (= empty set) is equal.


Parameters

Objects1 (input_object)
object-array -> object
Test objects

Objects2 (input_object)
object-array -> object
Comparative objects


Complexity

If F is the area of a region the runtime complexity is O(1) or O(F) if the result is TRUE and O(sqrt(F)) if the result is FALSE.


Result

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


See also

equal_region


Return Value

bool



Copyright © 1996-1997 MVTec Software GmbH