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_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) → objectHRegionHObjectHRegionHobject
Input region(s).
RegionFillUpRegionFillUpRegionFillUpRegionFillUpregionFillUpregion_fill_up (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Output region(s) with filled holes.
FeatureFeatureFeatureFeaturefeaturefeature (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Shape feature used.
Default:
'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 → 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
min
MaxMaxMaxMaxmaxmax (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
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
See also
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape,
connectionconnectionConnectionConnectionConnectionconnection,
area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center
Module
Foundation