Herror ::closing_circle (
    Hobject Region,
    Hobject *RegionClosing,
    const HTuple &Radius
)
HRegion HRegion::ClosingCircle (
    const HTuple &Radius
) const
HRegionArray HRegionArray::ClosingCircle (
    const HTuple &Radius
) const

Close a region with a circular structuring element.

::closing_circle behaves analogously to ::closing, i.e., the regions' boundaries are smoothed and holes within a region which are smaller than the circular structuring element of radius Radius are closed. The ::closing_circle operation is defined as a dilation followed by a Minkowski subtraction, both with the same circular structuring element.


Attention

::closing_circle is applied to each input region separately. If gaps between different regions are to be closed, ::union1 or ::union2 has to be called first.


Parameters

Region (input_object)
region(-array) -> Hobject: HRegion(Array)
Regions to be closed.

RegionClosing (output_object)
region(-array) -> Hobject * : HRegion(Array)
Closed regions.

Radius (input_control)
real -> HTuple.double / long
Radius of the circular structuring element.
Default value: 3.5
Suggested values: 1.5, 2.5, 3.5, 4.5, 5.5, 7.5, 9.5, 12.5, 15.5, 19.5, 25.5, 33.5, 45.5, 60.5, 110.5
Typical range of values: 0.5 <= Radius <= 511.5 (lin)
Minimum increment: 1.0
Recommended increment: 1.0


Example
my_closing_circle(Hobject In, double Radius, Hobject *Out)
{
  Hobject  tmp, StructElement;
  gen_circle(StructElement,100.0,100.0,Radius);
  dilation1(In,StructElement,&tmp,1);
  minkowski_sub1(tmp,StructElement,Out,1);
  clear_obj(tmp); clear_obj(StructElement);
}

Complexity

Let F1 be the area of the input region. Then the runtime complexity for one region is:

    O(4 * sqrt(F1) * Radius) .


Result

::closing_circle returns H_MSG_TRUE if all parameters are correct. The behavior in case of empty or no input region can be set via:

  a) no region:    set_system('no_object_result',<RegionResult>)
  b) empty region: set_system('empty_region_result',<RegionResult>)
Otherwise, an exception is raised.


Possible Predecessors

::threshold, ::regiongrowing, ::connection, ::union1, ::watersheds, ::class_ndim_norm


Possible Successors

::reduce_domain, ::select_shape, ::area_center, ::connection


Alternatives

::rank_region, ::fill_up, ::closing, ::closing_circle, ::closing_golay


See also

::dilation1, ::minkowski_sub1, ::erosion1, ::opening


Module

Morphology



Copyright © 1996-2002 MVTec Software GmbH