Herror ::complement (
    Hobject Region,
    Hobject *RegionComplement
)
HRegion HRegion::Complement (
    void
) const
HRegionArray HRegionArray::Complement (
    void
) const

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) -> Hobject: HRegion(Array)
Input region(s).

RegionComplement (output_object)
region(-array) -> Hobject * : HRegion(Array)
Complemented regions.
Number of elements: RegionComplement == Region


Result

::complement always returns the value 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.


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-2002 MVTec Software GmbH