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

thickening_seqthickening_seqthickening_seqThickeningSeqThickeningSeq (Operator)

Name

thickening_seqthickening_seqthickening_seqThickeningSeqThickeningSeq — Add the result of a hit-or-miss operation to a region (sequential).

Signature

thickening_seq(Region : RegionThick : GolayElement, Iterations : )

Herror thickening_seq(const Hobject Region, Hobject* RegionThick, const char* GolayElement, const Hlong Iterations)

Herror T_thickening_seq(const Hobject Region, Hobject* RegionThick, const Htuple GolayElement, const Htuple Iterations)

Herror thickening_seq(Hobject Region, Hobject* RegionThick, const HTuple& GolayElement, const HTuple& Iterations)

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

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

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

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

static void HOperatorSet.ThickeningSeq(HObject region, out HObject regionThick, HTuple golayElement, HTuple iterations)

HRegion HRegion.ThickeningSeq(string golayElement, int iterations)

Description

thickening_seqthickening_seqthickening_seqThickeningSeqThickeningSeq calculates the sequential thickening of the input regions with a structuring element from the Golay alphabet (GolayElementGolayElementGolayElementGolayElementgolayElement). To do so, thickening_seqthickening_seqthickening_seqThickeningSeqThickeningSeq calls the operator thickening_golaythickening_golaythickening_golayThickeningGolayThickeningGolay with all possible rotations of the structuring element IterationsIterationsIterationsIterationsiterations times. The following structuring elements are available:

'l', 'm', 'd', 'c', 'e', 'i', 'f', 'f2', 'h', 'k'.

The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsgolay_elementsGolayElementsGolayElements. For all elements of the Golay alphabet, except for 'c', the foreground and background masks are exchanged in order to have an effect for them on the outer boundary of the region. The element 'c' can be used to generate the convex hull of the input region if enough iterations are performed.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Regions to be processed.

RegionThickRegionThickRegionThickRegionThickregionThick (output_object)  region(-array) objectHRegionHRegionHRegionXHobject *

Result of the thickening operator.

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", 'm'"m""m""m""m", 'd'"d""d""d""d", 'c'"c""c""c""c", 'e'"e""e""e""e", 'i'"i""i""i""i", 'f'"f""f""f""f", 'f2'"f2""f2""f2""f2", '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, 70, 100, 200

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 * 6 * sqrt(F)) .

Result

thickening_seqthickening_seqthickening_seqThickeningSeqThickeningSeq 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 Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeselect_shapeSelectShapeSelectShape, area_centerarea_centerarea_centerAreaCenterAreaCenter, connectionconnectionconnectionConnectionConnection

Alternatives

thickening_golaythickening_golaythickening_golayThickeningGolayThickeningGolay, thickeningthickeningthickeningThickeningThickening

See also

erosion_golayerosion_golayerosion_golayErosionGolayErosionGolay, 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