complement ( Region : RegionComplement : : )

Return the complement of a region.

complement determines the complement of the input region(s).

If the system flag 'clip_region' is 'false' (see set_system) the complement is done virtually by setting the complement flag of Region to TRUE. For succeeding operations the de Morgan laws are applied while calculating results.

If the system flag 'clip_region' is 'true' the difference of the largest image processed so far (see reset_obj_db) and the input region is returned.


Parameters

Region (input_object)
region(-array) -> object
Input region(s).

RegionComplement (output_object)
region(-array) -> object
Complemented regions.
Number of elements: RegionComplement == Region


Result

complement always returns the value 2 (H_MSG_TRUE). The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>). If necessary, an exception handling is raised.


Parallelization Information

complement is reentrant and automatically parallelized (on tuple level).


Possible Predecessors

threshold, connection, regiongrowing, pouring, class_ndim_norm


Possible Successors

select_shape


See also

difference, union1, union2, intersection, reset_obj_db, set_system


Module

Region processing



Copyright © 1996-2005 MVTec Software GmbH