Herror ::eliminate_runs (
    Hobject Region,
    Hobject *RegionClipped,
    const HTuple &ElimShorter,
    const HTuple &ElimLonger
)
HRegion HRegion::EliminateRuns (
    const HTuple &ElimShorter,
    const HTuple &ElimLonger
) const
HRegionArray HRegionArray::EliminateRuns (
    const HTuple &ElimShorter,
    const HTuple &ElimLonger
) const

Eliminate runs of a given length.

::eliminate_runs eliminates all runs of the run length encoding of the input regions which are shorter than ElimShorter or longer as ElimLonger.


Parameters

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

RegionClipped (output_object)
region(-array) -> Hobject * : HRegion(Array)
Clipped regions.

ElimShorter (input_control)
integer -> HTuple.long
All runs which are shorter are eliminated.
Default value: 3
Suggested values: 2, 3, 4, 5, 6, 8, 10, 12, 15
Typical range of values: 1 <= ElimShorter <= 500 (lin)
Minimum increment: 1
Recommended increment: 1

ElimLonger (input_control)
integer -> HTuple.long
All runs which are longer are eliminated.
Default value: 1000
Suggested values: 50, 100, 200, 500, 1000, 2000
Typical range of values: 1 <= ElimLonger <= 10000 (lin)
Minimum increment: 1
Recommended increment: 10


Result

::eliminate_runs returns H_MSG_TRUE if all parameters are correct. 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


Possible Successors

::erosion1, ::dilation1, ::disp_region


Alternatives

::shape_trans


Module

Region processing



Copyright © 1996-2002 MVTec Software GmbH