gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape (Operator)

Name

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

Signatur

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

Beschreibung

gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape transformiert die Grauwerte der Eingabebilder aus ImageImageImageimageimage mit Hilfe einer Filtermaske der Größe MaskHeightMaskHeightMaskHeightmaskHeightmask_height und MaskWidthMaskWidthMaskWidthmaskWidthmask_width der Form MaskShapeMaskShapeMaskShapemaskShapemask_shape, in der das Minimum der Grauwerte berechnet wird. Das Ergebnis wird in ImageMinImageMinImageMinimageMinimage_min zurückgeliefert.

Die Steuerparameter MaskHeightMaskHeightMaskHeightmaskHeightmask_height und MaskWidthMaskWidthMaskWidthmaskWidthmask_width 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 ImageMinImageMinImageMinimageMinimage_min aus den beiden Zwischenergebnissen interpoliert. Es ist daher zu beachten, dass gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape für Maskengrößen von z.B. 4 und 4.0 unterschiedliche Ergebnisse liefert!

Im Falle der Maskenformen 'rhombus' und 'octagon' für Steuerparameter MaskShapeMaskShapeMaskShapemaskShapemask_shape müssen die Werte für MaskHeightMaskHeightMaskHeightmaskHeightmask_height und MaskWidthMaskWidthMaskWidthmaskWidthmask_width gleich groß sein. Der Parameterwert 'octagon' für MaskShapeMaskShapeMaskShapemaskShapemask_shape 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_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape 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_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape 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

Unterstützt OpenCL Compute Devices.
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.
Automatisch parallelisiert auf Kanalebene.
Automatisch parallelisiert auf Domainebene.

Parameter

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

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

ImageMinImageMinImageMinimageMinimage_min (output_object) (multichannel-)image(-array) → object (byte / uint2)

Bilder, die die Minima enthalten.

MaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control) extent.y → (real / integer)

Höhe der Filtermaske.

Default: 11

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

Wertebereich: 1.0 ≤ MaskHeight MaskHeight MaskHeight maskHeight mask_height

MaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control) extent.x → (real / integer)

Breite der Filtermaske.

Default: 11

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

Wertebereich: 1.0 ≤ MaskWidth MaskWidth MaskWidth maskWidth mask_width

MaskShapeMaskShapeMaskShapemaskShapemask_shape (input_control) string → (string)

Form der Maske.

Default: '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_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape liefert 2 ( H_MSG_TRUE) zurück, wenn alle Parameter korrekt sind.

Alternativen

gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectgray_erosion_rect

Siehe auch

gray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShapegray_opening_shape, gray_closing_shapegray_closing_shapeGrayClosingShapeGrayClosingShapegray_closing_shape, gray_skeletongray_skeletonGraySkeletonGraySkeletongray_skeleton

Modul

Foundation

Operatoren