fill_up_shapefill_up_shapeFillUpShapeFillUpShape (Operator)

Name

fill_up_shapefill_up_shapeFillUpShapeFillUpShape — Fill up holes in regions having given shape features.

Signature

fill_up_shape(Region : RegionFillUp : Feature, Min, Max : )

Description

fill_up_shapefill_up_shapeFillUpShapeFillUpShapeFillUpShape fills up those holes in the input region RegionRegionRegionRegionregion having given shape features. The parameter FeatureFeatureFeatureFeaturefeature determines the shape feature to be used, while MinMinMinMinmin and MaxMaxMaxMaxmax determine the range the shape feature has to lie in in order for the hole to be filled up.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.

Parameters

RegionRegionRegionRegionregion (input_object) region(-array) → object

Input region(s).

RegionFillUpRegionFillUpRegionFillUpRegionFillUpregionFillUp (output_object) region(-array) → object

Output region(s) with filled holes.

FeatureFeatureFeatureFeaturefeature (input_control) string → (string)

Shape feature used.

Default value: 'area' "area" "area" "area" "area"

List of values: 'anisometry'"anisometry""anisometry""anisometry""anisometry", 'area'"area""area""area""area", 'compactness'"compactness""compactness""compactness""compactness", 'convexity'"convexity""convexity""convexity""convexity", 'inner_circle'"inner_circle""inner_circle""inner_circle""inner_circle", 'outer_circle'"outer_circle""outer_circle""outer_circle""outer_circle", 'phi'"phi""phi""phi""phi", 'ra'"ra""ra""ra""ra", 'rb'"rb""rb""rb""rb"

MinMinMinMinmin (input_control) number → (real / integer)

Minimum value for Feature.

Default value: 1.0

Suggested values: 0.0, 1.0, 10.0, 50.0, 100.0, 500.0, 1000.0, 10000.0

Typical range of values: 0.0 ≤ Min Min Min Min min

MaxMaxMaxMaxmax (input_control) number → (real / integer)

Maximum value for Feature.

Default value: 100.0

Suggested values: 10.0, 50.0, 100.0, 500.0, 1000.0, 10000.0, 100000.0

Typical range of values: 0.0 ≤ Max Max Max Max max

Example (C)

read_image(&Image,"monkey");
threshold(Image,&Seg,120.0,255.0);
fill_up_shape(Seg,&Filled,"area",0.0,200.0);

Result

fill_up_shapefill_up_shapeFillUpShapeFillUpShapeFillUpShape returns 2 (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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, pouringpouringPouringPouringPouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, disp_regiondisp_regionDispRegionDispRegionDispRegion

Alternatives

fill_upfill_upFillUpFillUpFillUp

Module

Foundation

Operators