Name
dilation2dilation2Dilation2dilation2Dilation2Dilation2 — Dilate a region (using a reference point).
Herror dilation2(const Hobject Region, const Hobject StructElement, Hobject* RegionDilation, const Hlong Row, const Hlong Column, const Hlong Iterations)
Herror T_dilation2(const Hobject Region, const Hobject StructElement, Hobject* RegionDilation, const Htuple Row, const Htuple Column, const Htuple Iterations)
Herror dilation2(Hobject Region, Hobject StructElement, Hobject* RegionDilation, const HTuple& Row, const HTuple& Column, const HTuple& Iterations)
HRegion HRegion::Dilation2(const HRegion& StructElement, const HTuple& Row, const HTuple& Column, const HTuple& Iterations) const
HRegionArray HRegionArray::Dilation2(const HRegion& StructElement, const HTuple& Row, const HTuple& Column, const HTuple& Iterations) const
dilation2dilation2Dilation2dilation2Dilation2Dilation2 dilates the input regions with a structuring
element (StructElementStructElementStructElementStructElementStructElementstructElement) having the reference point
(RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn). dilation2dilation2Dilation2dilation2Dilation2Dilation2 has a
similar effect as dilation1dilation1Dilation1dilation1Dilation1Dilation1, the difference is that
the reference point of the structuring element can be chosen
arbitrarily. The parameter IterationsIterationsIterationsIterationsIterationsiterations determines the
number of iterations which are to be performed with the structuring
element. The result of iteration n-1 is used as input for
iteration n.
An empty region is generated in case of an empty structuring
element.
Structuring elements (StructElementStructElementStructElementStructElementStructElementstructElement) can be generated
with operators such as gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle, gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1,
gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2, gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse,
draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion, gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon,
gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints, etc.
A dilation always results in enlarged regions. Closely
spaced regions which may touch or overlap as a result of the
dilation are still treated as two separate regions. If the desired
behavior is to merge them into one region, the operator
union1union1Union1union1Union1Union1 has to be called first.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Row coordinate of the reference point.
Default value: 0
Column coordinate of the reference point.
Default value: 0
Number of iterations.
Default value: 1
Suggested values: 1, 2, 3, 4, 5, 7, 11, 17, 25, 32, 64, 128
Typical range of values: 1
≤
Iterations
Iterations
Iterations
Iterations
Iterations
iterations
(lin)
Minimum increment: 1
Recommended increment: 1
Let F1 be the area of the input region, and F2 be the area of
the structuring element. Then the runtime complexity for one region
is:
dilation2dilation2Dilation2dilation2Dilation2Dilation2 returns 2 (H_MSG_TRUE) if all parameters are correct.
The behavior in case of empty or no input region can be set via:
-
no region:
set_system('no_object_result',<RegionResult>)
-
empty region:
set_system('empty_region_result',<RegionResult>)
Otherwise, an exception is raised.
thresholdthresholdThresholdthresholdThresholdThreshold,
regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing,
connectionconnectionConnectionconnectionConnectionConnection,
union1union1Union1union1Union1Union1,
watershedswatershedsWatershedswatershedsWatershedsWatersheds,
class_ndim_normclass_ndim_normClassNdimNormclass_ndim_normClassNdimNormClassNdimNorm,
gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle,
gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse,
gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1,
gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2,
draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion,
gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints,
gen_struct_elementsgen_struct_elementsGenStructElementsgen_struct_elementsGenStructElementsGenStructElements,
gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilled
reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain,
add_channelsadd_channelsAddChannelsadd_channelsAddChannelsAddChannels,
select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape,
area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter,
connectionconnectionConnectionconnectionConnectionConnection
minkowski_add1minkowski_add1MinkowskiAdd1minkowski_add1MinkowskiAdd1MinkowskiAdd1,
minkowski_add2minkowski_add2MinkowskiAdd2minkowski_add2MinkowskiAdd2MinkowskiAdd2,
dilation1dilation1Dilation1dilation1Dilation1Dilation1,
dilation_golaydilation_golayDilationGolaydilation_golayDilationGolayDilationGolay,
dilation_seqdilation_seqDilationSeqdilation_seqDilationSeqDilationSeq
erosion1erosion1Erosion1erosion1Erosion1Erosion1,
erosion2erosion2Erosion2erosion2Erosion2Erosion2,
openingopeningOpeningopeningOpeningOpening,
closingclosingClosingclosingClosingClosing
Foundation