fill_up_shapefill_up_shapeFillUpShapeFillUpShapefill_up_shape (Operator)

Name

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

Signature

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

Description

fill_up_shapefill_up_shapeFillUpShapeFillUpShapeFillUpShapefill_up_shape fills up those holes in the input region RegionRegionRegionRegionregionregion having given shape features. The parameter FeatureFeatureFeatureFeaturefeaturefeature determines the shape feature to be used, while MinMinMinMinminmin and MaxMaxMaxMaxmaxmax 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

RegionRegionRegionRegionregionregion (input_object) region(-array) → object

Input region(s).

RegionFillUpRegionFillUpRegionFillUpRegionFillUpregionFillUpregion_fill_up (output_object) region(-array) → object

Output region(s) with filled holes.

FeatureFeatureFeatureFeaturefeaturefeature (input_control) string → (string)

Shape feature used.

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

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

MinMinMinMinminmin (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 min

MaxMaxMaxMaxmaxmax (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 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_shapeFillUpShapeFillUpShapeFillUpShapefill_up_shape 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>)set_system("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>)set_system("empty_region_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Alternatives

fill_upfill_upFillUpFillUpFillUpfill_up

Module

Foundation

Operators