HALCON Website / HALCON Operator-Referenz / Morphologie / Grauwerte
KlassenKlassen | | Operatoren

gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShape (Operator)

Name

gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShape — Minimum der Grauwerte in einer ausgewählten Maske.

Signatur

gray_erosion_shape(Image : ImageMin : MaskHeight, MaskWidth, MaskShape : )

Herror gray_erosion_shape(const Hobject Image, Hobject* ImageMin, double MaskHeight, double MaskWidth, const char* MaskShape)

Herror T_gray_erosion_shape(const Hobject Image, Hobject* ImageMin, const Htuple MaskHeight, const Htuple MaskWidth, const Htuple MaskShape)

void GrayErosionShape(const HObject& Image, HObject* ImageMin, const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape)

HImage HImage::GrayErosionShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HString& MaskShape) const

HImage HImage::GrayErosionShape(double MaskHeight, double MaskWidth, const HString& MaskShape) const

HImage HImage::GrayErosionShape(double MaskHeight, double MaskWidth, const char* MaskShape) const

HImage HImage::GrayErosionShape(double MaskHeight, double MaskWidth, const wchar_t* MaskShape) const   (Nur Windows)

static void HOperatorSet.GrayErosionShape(HObject image, out HObject imageMin, HTuple maskHeight, HTuple maskWidth, HTuple maskShape)

HImage HImage.GrayErosionShape(HTuple maskHeight, HTuple maskWidth, string maskShape)

HImage HImage.GrayErosionShape(double maskHeight, double maskWidth, string maskShape)

Beschreibung

gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape transformiert die Grauwerte der Eingabebilder aus ImageImageImageImageimage mit Hilfe einer Filtermaske der Größe MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight und MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth der Form MaskShapeMaskShapeMaskShapeMaskShapemaskShape, in der das Minimum der Grauwerte berechnet wird. Das Ergebnis wird in ImageMinImageMinImageMinImageMinimageMin zurückgeliefert.

Die Steuerparameter MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight und MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth werden, wenn sie vom Typ Integer sind und einen geraden Wert haben, auf den nächstgrößeren ungeraden Wert transformiert. Ist dagegen mindestens einer der beiden Parameter vom Typ Float, dann wird das Eingabebild ImageImageImageImageimage zunächst mit der jeweils nächstgrößeren und nächstkleineren ungeraden Maskengröße gefiltert und das Ergebnisbild ImageMinImageMinImageMinImageMinimageMin aus den beiden Zwischenergebnissen interpoliert. Es ist daher zu beachten, dass gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape für Maskengrößen von z.B. 4 und 4.0 unterschiedliche Ergebnisse liefert!

Im Falle der Maskenformen 'rhombus' und 'octagon' für Steuerparameter MaskShapeMaskShapeMaskShapeMaskShapemaskShape müssen die Werte für MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight und MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth gleich groß sein. Der Parameterwert 'octagon' für MaskShapeMaskShapeMaskShapeMaskShapemaskShape beschreibt eine gleichseitige, achteckige Maske, welche sich als Näherung von kreisförmigen Maskenstrukturen eignet. An den Bildrändern wird eine Spiegelung der Randpunkte durchgeführt.

Achtung

Es ist zu beachten, dass gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape für Maskengrößen des Typs Float spürbar mehr Rechenzeit benötigt als für Maskengrößen des Typs Integer. Dies gilt insbesondere für rechteckige Masken mit unterschiedlicher Breite und Höhe!

gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape kann auf OpenCL-Geräten ausgeführt werden. Wird eine Maskengröße des Typs Float verwendet, kann das Ergebnis geringfügig von dem der CPU abweichen, da die Interpolation auf dem OpenCL-Gerät in einfacher Genauigkeit durchgeführt wird.

Beachten Sie, dass Filteroperatoren eventuell unerwartete Resultate ausgeben, wenn ein Bild mit einer reduzierten Domäne als Input übergeben wird. Weitere Informationen können im Kapitel Filter gefunden werden.

Ausführungsinformationen

Parameter

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) → objectHImageHImageHobject (byte* / uint2*) *erlaubt für Compute Devices

Bilder, für deren Grauwerte die Minima berechnet werden sollen.

ImageMinImageMinImageMinImageMinimageMin (output_object)  (multichannel-)image(-array) → objectHImageHImageHobject * (byte / uint2)

Bilder, die die Minima enthalten.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Höhe der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15

Typischer Wertebereich: 1.0 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Breite der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15

Typischer Wertebereich: 1.0 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth

MaskShapeMaskShapeMaskShapeMaskShapemaskShape (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Form der Maske.

Defaultwert: 'octagon' "octagon" "octagon" "octagon" "octagon"

Werteliste: 'octagon'"octagon""octagon""octagon""octagon", 'rectangle'"rectangle""rectangle""rectangle""rectangle", 'rhombus'"rhombus""rhombus""rhombus""rhombus"

Ergebnis

gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape liefert 2 (H_MSG_TRUE) zurück, wenn alle Parameter korrekt sind.

Alternativen

gray_erosiongray_erosionGrayErosionGrayErosionGrayErosion, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRect

Siehe auch

gray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShapeGrayOpeningShape, gray_closing_shapegray_closing_shapeGrayClosingShapeGrayClosingShapeGrayClosingShape, gray_skeletongray_skeletonGraySkeletonGraySkeletonGraySkeleton

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH