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
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)
def fill_up_shape(region: HObject, feature: str, min: Union[int, float], max: Union[int, float]) -> HObject
Description
fill_up_shapefill_up_shapeFillUpShapeFillUpShapefill_up_shape 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) → objectHRegionHObjectHObjectHobject
Input region(s).
RegionFillUpRegionFillUpRegionFillUpregionFillUpregion_fill_up (output_object) region(-array) → objectHRegionHObjectHObjectHobject *
Output region(s) with filled holes.
FeatureFeatureFeaturefeaturefeature (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Shape feature used.
Default:
'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 → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Minimum value for Feature.
Default:
1.0
Suggested values:
0.0, 1.0, 10.0, 50.0, 100.0, 500.0, 1000.0, 10000.0
Value range:
0.0
≤
Min
Min
Min
min
min
MaxMaxMaxmaxmax (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Maximum value for Feature.
Default:
100.0
Suggested values:
10.0, 50.0, 100.0, 500.0, 1000.0, 10000.0, 100000.0
Value range:
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_shapeFillUpShapeFillUpShapefill_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>)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>)set_system("empty_region_result",<Result>).
If necessary, an exception is raised.
Possible Predecessors
thresholdthresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringpouring
Possible Successors
select_shapeselect_shapeSelectShapeSelectShapeselect_shape,
disp_regiondisp_regionDispRegionDispRegiondisp_region
Alternatives
fill_upfill_upFillUpFillUpfill_up
See also
select_shapeselect_shapeSelectShapeSelectShapeselect_shape,
connectionconnectionConnectionConnectionconnection,
area_centerarea_centerAreaCenterAreaCenterarea_center
Module
Foundation