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

hit_or_miss_golayhit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolay (Operator)

Name

hit_or_miss_golayhit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolay — Hit-or-miss operation for regions using the Golay alphabet.

Signature

hit_or_miss_golay(Region : RegionHitMiss : GolayElement, Rotation : )

Herror hit_or_miss_golay(const Hobject Region, Hobject* RegionHitMiss, const char* GolayElement, const Hlong Rotation)

Herror T_hit_or_miss_golay(const Hobject Region, Hobject* RegionHitMiss, const Htuple GolayElement, const Htuple Rotation)

Herror hit_or_miss_golay(Hobject Region, Hobject* RegionHitMiss, const HTuple& GolayElement, const HTuple& Rotation)

HRegion HRegion::HitOrMissGolay(const HTuple& GolayElement, const HTuple& Rotation) const

HRegionArray HRegionArray::HitOrMissGolay(const HTuple& GolayElement, const HTuple& Rotation) const

void HOperatorSetX.HitOrMissGolay(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX*RegionHitMiss, [in] VARIANT GolayElement, [in] VARIANT Rotation)

IHRegionX* HRegionX.HitOrMissGolay(
[in] BSTR GolayElement, [in] Hlong Rotation)

static void HOperatorSet.HitOrMissGolay(HObject region, out HObject regionHitMiss, HTuple golayElement, HTuple rotation)

HRegion HRegion.HitOrMissGolay(string golayElement, int rotation)

Description

hit_or_miss_golayhit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolay performs the hit-or-miss-transformation for the input regions RegionRegionRegionRegionregion (using structuring elements from the Golay alphabet). First, an erosion with the foreground of the structuring element GolayElementGolayElementGolayElementGolayElementgolayElement is done on the input region RegionRegionRegionRegionregion. Then an erosion with the background of the structuring element GolayElementGolayElementGolayElementGolayElementgolayElement is performed on the complement of the input region. The intersection of the two resulting regions is the result RegionHitMissRegionHitMissRegionHitMissRegionHitMissregionHitMiss of hit_or_miss_golayhit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolay. The following structuring elements are available:

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

The rotation number RotationRotationRotationRotationrotation determines which rotation of the element should be used. The hit-or-miss-transformation selects precisely the points for which the conditions given by the selected Golay element are fulfilled.

Attention

Not all values of RotationRotationRotationRotationrotation are valid for any Golay element.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Regions to be processed.

RegionHitMissRegionHitMissRegionHitMissRegionHitMissregionHitMiss (output_object)  region(-array) objectHRegionHRegionHRegionXHobject *

Result of the hit-or-miss operation.

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"

RotationRotationRotationRotationrotation (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Rotation of the Golay element. Depending on the element, not all rotations are valid.

Default value: 0

List of values: 0, 2, 4, 6, 8, 10, 12, 14, 1, 3, 5, 7, 9, 11, 13, 15

Complexity

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

       O(6 * sqrt(F)) .

Result

hit_or_miss_golayhit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolay 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

hit_or_miss_seqhit_or_miss_seqhit_or_miss_seqHitOrMissSeqHitOrMissSeq, hit_or_misshit_or_misshit_or_missHitOrMissHitOrMiss

See also

erosion_golayerosion_golayerosion_golayErosionGolayErosionGolay, dilation_golaydilation_golaydilation_golayDilationGolayDilationGolay, opening_golayopening_golayopening_golayOpeningGolayOpeningGolay, closing_golayclosing_golayclosing_golayClosingGolayClosingGolay, thinning_golaythinning_golaythinning_golayThinningGolayThinningGolay, thickening_golaythickening_golaythickening_golayThickeningGolayThickeningGolay, golay_elementsgolay_elementsgolay_elementsGolayElementsGolayElements

Module

Foundation


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