union1 ( Region : RegionUnion : : )

Return the union of all input regions.

union1 computes the union of all input regions and returns the result in RegionUnion.


Parameters

Region (input_object)
region-array -> object
Regions of which the union is to be computed.

RegionUnion (output_object)
region -> object
Union of all input regions.
Number of elements: RegionUnion <= Region


Example
/* Union of segmentation results: */
threshold__(Image:Seg1:128,255:)
dyn_threshold__(Image,Mean:Seg2:5,'light':)
union1([Seg1,Seg2]:Seg::)

Complexity

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


Result

union1 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

union2


See also

intersection, complement__



Copyright © 1996-1997 MVTec Software GmbH