ClassesClassesClassesClasses | | | | Operators

minkowski_sub2minkowski_sub2MinkowskiSub2minkowski_sub2MinkowskiSub2MinkowskiSub2 (Operator)

Name

minkowski_sub2minkowski_sub2MinkowskiSub2minkowski_sub2MinkowskiSub2MinkowskiSub2 — Erode a region (using a reference point).

Signature

minkowski_sub2(Region, StructElement : RegionMinkSub : Row, Column, Iterations : )

Herror minkowski_sub2(const Hobject Region, const Hobject StructElement, Hobject* RegionMinkSub, const Hlong Row, const Hlong Column, const Hlong Iterations)

Herror T_minkowski_sub2(const Hobject Region, const Hobject StructElement, Hobject* RegionMinkSub, const Htuple Row, const Htuple Column, const Htuple Iterations)

Herror minkowski_sub2(Hobject Region, Hobject StructElement, Hobject* RegionMinkSub, const HTuple& Row, const HTuple& Column, const HTuple& Iterations)

HRegion HRegion::MinkowskiSub2(const HRegion& StructElement, const HTuple& Row, const HTuple& Column, const HTuple& Iterations) const

HRegionArray HRegionArray::MinkowskiSub2(const HRegion& StructElement, const HTuple& Row, const HTuple& Column, const HTuple& Iterations) const

void MinkowskiSub2(const HObject& Region, const HObject& StructElement, HObject* RegionMinkSub, const HTuple& Row, const HTuple& Column, const HTuple& Iterations)

HRegion HRegion::MinkowskiSub2(const HRegion& StructElement, Hlong Row, Hlong Column, Hlong Iterations) const

void HOperatorSetX.MinkowskiSub2(
[in] IHUntypedObjectX* Region, [in] IHUntypedObjectX* StructElement, [out] IHUntypedObjectX*RegionMinkSub, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Iterations)

IHRegionX* HRegionX.MinkowskiSub2(
[in] IHRegionX* StructElement, [in] Hlong Row, [in] Hlong Column, [in] Hlong Iterations)

static void HOperatorSet.MinkowskiSub2(HObject region, HObject structElement, out HObject regionMinkSub, HTuple row, HTuple column, HTuple iterations)

HRegion HRegion.MinkowskiSub2(HRegion structElement, int row, int column, int iterations)

Description

minkowski_sub2minkowski_sub2MinkowskiSub2minkowski_sub2MinkowskiSub2MinkowskiSub2 computes the Minkowski subtraction of the input regions with a structuring element (StructElementStructElementStructElementStructElementStructElementstructElement) having the reference point (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn). minkowski_sub2minkowski_sub2MinkowskiSub2minkowski_sub2MinkowskiSub2MinkowskiSub2 has a similar effect as minkowski_sub1minkowski_sub1MinkowskiSub1minkowski_sub1MinkowskiSub1MinkowskiSub1, 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.

A maximum 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.

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Regions to be eroded.

StructElementStructElementStructElementStructElementStructElementstructElement (input_object)  region objectHRegionHRegionHRegionHRegionXHobject

Structuring element.

RegionMinkSubRegionMinkSubRegionMinkSubRegionMinkSubRegionMinkSubregionMinkSub (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Eroded regions.

RowRowRowRowRowrow (input_control)  point.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinate of the reference point.

Default value: 0

Suggested values: 0, 10, 16, 32, 64, 100, 128

Typical range of values: 0 ≤ Row Row Row Row Row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinate of the reference point.

Default value: 0

Suggested values: 0, 10, 16, 32, 64, 100, 128

Typical range of values: 0 ≤ Column Column Column Column Column column ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

IterationsIterationsIterationsIterationsIterationsiterations (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of iterations.

Default value: 1

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 15, 17, 20, 30, 40, 50

Typical range of values: 1 ≤ Iterations Iterations Iterations Iterations Iterations iterations (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

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:

Result

minkowski_sub2minkowski_sub2MinkowskiSub2minkowski_sub2MinkowskiSub2MinkowskiSub2 returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via:

Otherwise, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, 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

Possible Successors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

minkowski_sub1minkowski_sub1MinkowskiSub1minkowski_sub1MinkowskiSub1MinkowskiSub1, erosion1erosion1Erosion1erosion1Erosion1Erosion1, erosion2erosion2Erosion2erosion2Erosion2Erosion2, erosion_golayerosion_golayErosionGolayerosion_golayErosionGolayErosionGolay, erosion_seqerosion_seqErosionSeqerosion_seqErosionSeqErosionSeq

See also

gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle, gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2, gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon

Module

Foundation


ClassesClassesClassesClasses | | | | Operators