union2 ( Region1, Region2 : RegionUnion : : )

Return the union of two regions.

union2 computes the union of the region in Region1 with all regions in Region2. This means that union2 is not commutative!


Parameters

Region1 (input_object)
region(-array) -> object
Region for which the union with all regions in Region2 is to be computed.

Region2 (input_object)
region(-array) -> object
Regions which should be added to Region1.

RegionUnion (output_object)
region(-array) -> object
Resulting regions.
Number of elements: RegionUnion == Region1


Complexity

Let F be the sum of all areas of the input regions. Then the runtime complexity is O(F) * F).


Result

union2 always returns 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 is raised.


Possible Predecessors

threshold__, connection, regiongrowing__, pouring


Possible Successors

select_shape, disp_region


Alternatives

union1


See also

intersection, complement__



Copyright © 1996-1997 MVTec Software GmbH