HALCON Reference Manual 10.0.2
Table of Contents / Regions / Transformations ClassesClassesClasses | | | Operators

fill_up_shapefill_up_shapefill_up_shapeFillUpShapeFillUpShape (Operator)

Name

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

Herror fill_up_shape(Hobject Region, Hobject* RegionFillUp, const HTuple& Feature, const HTuple& Min, const HTuple& Max)

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

HRegionArray HRegionArray::FillUpShape(const HTuple& Feature, const HTuple& Min, const HTuple& Max) const

void HOperatorSetX.FillUpShape(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX** RegionFillUp, [in] VARIANT Feature, [in] VARIANT Min, [in] VARIANT Max)

IHRegionX* HRegionX.FillUpShape(
[in] BSTR Feature, [in] VARIANT Min, [in] VARIANT Max)

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_shapefill_up_shapeFillUpShapeFillUpShape 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.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) → objectHRegionHRegionHRegionXHobject

Input region(s).

RegionFillUpRegionFillUpRegionFillUpRegionFillUpregionFillUp (output_object)  region(-array) → objectHRegionHRegionHRegionXHobject *

Output region(s) with filled holes.

FeatureFeatureFeatureFeaturefeature (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Shape feature used.

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

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

MinMinMinMinmin (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (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 → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (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_shapefill_up_shapeFillUpShapeFillUpShape 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>)set_system("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>)set_system("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_shapeselect_shapeSelectShapeSelectShape, disp_regiondisp_regiondisp_regionDispRegionDispRegion

Alternatives

fill_upfill_upfill_upFillUpFillUp

See also

select_shapeselect_shapeselect_shapeSelectShapeSelectShape, connectionconnectionconnectionConnectionConnection, area_centerarea_centerarea_centerAreaCenterAreaCenter

Module

Foundation

Table of Contents / Regions / Transformations ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH