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 : )

Herror fill_up_shape(const Hobject Region, Hobject* RegionFillUp, const char* Feature, double Min, double Max)

Herror T_fill_up_shape(const Hobject Region, Hobject* RegionFillUp, const Htuple Feature, const Htuple Min, const Htuple Max)

void FillUpShape(const HObject& Region, HObject* RegionFillUp, const HTuple& Feature, const HTuple& Min, const HTuple& Max)

HRegion HRegion::FillUpShape(const HString& Feature, const HTuple& Min, const HTuple& Max) const

HRegion HRegion::FillUpShape(const HString& Feature, double Min, double Max) const

HRegion HRegion::FillUpShape(const char* Feature, double Min, double Max) const

HRegion HRegion::FillUpShape(const wchar_t* Feature, double Min, double Max) const   (Windows only)

static void HOperatorSet.FillUpShape(HObject region, out HObject regionFillUp, HTuple feature, HTuple min, HTuple max)

HRegion HRegion.FillUpShape(string feature, HTuple min, HTuple max)

HRegion HRegion.FillUpShape(string feature, double min, double 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

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHobject

Input region(s).

RegionFillUpRegionFillUpRegionFillUpRegionFillUpregionFillUp (output_object)  region(-array) objectHRegionHRegionHobject *

Output region(s) with filled holes.

FeatureFeatureFeatureFeaturefeature (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

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 HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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 HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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

See also

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, connectionconnectionConnectionConnectionConnection, area_centerarea_centerAreaCenterAreaCenterAreaCenter

Module

Foundation