HALCON Reference Manual 10.0.2
Table of Contents / Morphology / Region ClassesClassesClasses | | | Operators

dilation_seqdilation_seqdilation_seqDilationSeqDilationSeq (Operator)

Name

dilation_seqdilation_seqdilation_seqDilationSeqDilationSeq — Dilate a region sequentially.

Signature

dilation_seq(Region : RegionDilation : GolayElement, Iterations : )

Herror dilation_seq(const Hobject Region, Hobject* RegionDilation, const char* GolayElement, const Hlong Iterations)

Herror T_dilation_seq(const Hobject Region, Hobject* RegionDilation, const Htuple GolayElement, const Htuple Iterations)

Herror dilation_seq(Hobject Region, Hobject* RegionDilation, const HTuple& GolayElement, const HTuple& Iterations)

HRegion HRegion::DilationSeq(const HTuple& GolayElement, const HTuple& Iterations) const

HRegionArray HRegionArray::DilationSeq(const HTuple& GolayElement, const HTuple& Iterations) const

void HOperatorSetX.DilationSeq(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX*RegionDilation, [in] VARIANT GolayElement, [in] VARIANT Iterations)

IHRegionX* HRegionX.DilationSeq(
[in] BSTR GolayElement, [in] Hlong Iterations)

static void HOperatorSet.DilationSeq(HObject region, out HObject regionDilation, HTuple golayElement, HTuple iterations)

HRegion HRegion.DilationSeq(string golayElement, int iterations)

Description

dilation_seqdilation_seqdilation_seqDilationSeqDilationSeq computes the sequential dilation of the input region RegionRegionRegionRegionregion with the selected structuring element GolayElementGolayElementGolayElementGolayElementgolayElement from the Golay alphabet. This is done by executing the operator dilation_golaydilation_golaydilation_golayDilationGolayDilationGolay with all rotations of the structuring element IterationsIterationsIterationsIterationsiterations times. The following structuring elements can be selected:

'l', 'd', 'c', 'f', 'h', 'k'.

In order to compute the skeleton of a region, usually the elements 'l' and 'm' are used. Only the “foreground elements” (even rotation numbers) are used. The elements 'i' and 'e' result in unchanged output regions. The elements 'l', 'm' and 'f2' are identical for the foreground. The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsgolay_elementsGolayElementsGolayElements.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Regions to be dilated.

RegionDilationRegionDilationRegionDilationRegionDilationregionDilation (output_object)  region(-array) objectHRegionHRegionHRegionXHobject *

Dilated regions.

GolayElementGolayElementGolayElementGolayElementgolayElement (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Structuring element from the Golay alphabet.

Default value: 'h' "h" "h" "h" "h"

List of values: 'l'"l""l""l""l", 'd'"d""d""d""d", 'c'"c""c""c""c", 'f'"f""f""f""f", 'h'"h""h""h""h", 'k'"k""k""k""k"

IterationsIterationsIterationsIterationsiterations (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (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 (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

Let F be the area of an input region. Then the runtime complexity for one region is:

       O(Iterations * 20 * sqrt(F)) .

Result

dilation_seqdilation_seqdilation_seqDilationSeqDilationSeq 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

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionconnectionConnectionConnection, union1union1union1Union1Union1, watershedswatershedswatershedsWatershedsWatersheds, class_ndim_normclass_ndim_normclass_ndim_normClassNdimNormClassNdimNorm

Possible Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeselect_shapeSelectShapeSelectShape, area_centerarea_centerarea_centerAreaCenterAreaCenter, connectionconnectionconnectionConnectionConnection

Alternatives

dilation1dilation1dilation1Dilation1Dilation1, dilation2dilation2dilation2Dilation2Dilation2, dilation_golaydilation_golaydilation_golayDilationGolayDilationGolay

See also

erosion_seqerosion_seqerosion_seqErosionSeqErosionSeq, hit_or_miss_seqhit_or_miss_seqhit_or_miss_seqHitOrMissSeqHitOrMissSeq, thinning_seqthinning_seqthinning_seqThinningSeqThinningSeq

Module

Foundation


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