gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapegray_dilation_shape (Operator)
Name
gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapegray_dilation_shape — Maximum der Grauwerte in einer ausgewählten Maske.
Signatur
void GrayDilationShape(const HObject& Image, HObject* ImageMax, const HTuple& MaskHeight, const HTuple& MaskWidth, const HTuple& MaskShape)
HImage HImage::GrayDilationShape(const HTuple& MaskHeight, const HTuple& MaskWidth, const HString& MaskShape) const
HImage HImage::GrayDilationShape(double MaskHeight, double MaskWidth, const HString& MaskShape) const
HImage HImage::GrayDilationShape(double MaskHeight, double MaskWidth, const char* MaskShape) const
HImage HImage::GrayDilationShape(double MaskHeight, double MaskWidth, const wchar_t* MaskShape) const
(Nur Windows)
Beschreibung
gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_shape transformiert die Grauwerte der Eingabebilder aus
ImageImageImageImageimageimage mit Hilfe einer Filtermaske der Größe MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height
und MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width der Form MaskShapeMaskShapeMaskShapeMaskShapemaskShapemask_shape, in der das Maximum
der Grauwerte berechnet wird. Das Ergebnis wird in
ImageMaxImageMaxImageMaxImageMaximageMaximage_max zurückgeliefert.
Die Steuerparameter MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height und MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_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 ImageImageImageImageimageimage zunächst mit der jeweils nächstgrößeren und
nächstkleineren ungeraden Maskengröße gefiltert und das Ergebnisbild
ImageMaxImageMaxImageMaxImageMaximageMaximage_max aus den beiden Zwischenergebnissen interpoliert. Es ist
daher zu beachten, dass gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_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 MaskShapeMaskShapeMaskShapeMaskShapemaskShapemask_shape müssen die Werte
für MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height und MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width gleich groß sein.
An den Bildrändern wird eine Spiegelung der Randpunkte durchgeführt.
Achtung
Es ist zu beachten, dass gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_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_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_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
ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject (byte* / uint2*) *erlaubt für Compute Devices
Bilder, für deren Grauwerte die Maxima
berechnet werden sollen.
ImageMaxImageMaxImageMaxImageMaximageMaximage_max (output_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject * (byte / uint2)
Bilder, die die Maxima enthalten.
MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control) extent.y → HTupleUnion[int, float]HTupleHtuple (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
mask_height
MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control) extent.x → HTupleUnion[int, float]HTupleHtuple (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
mask_width
MaskShapeMaskShapeMaskShapeMaskShapemaskShapemask_shape (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Form der Maske.
Defaultwert:
'octagon'
"octagon"
"octagon"
"octagon"
"octagon"
"octagon"
Werteliste: 'octagon'"octagon""octagon""octagon""octagon""octagon", 'rectangle'"rectangle""rectangle""rectangle""rectangle""rectangle", 'rhombus'"rhombus""rhombus""rhombus""rhombus""rhombus"
Ergebnis
gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_shape liefert 2 (H_MSG_TRUE) zurück, wenn
alle Parameter korrekt sind.
Alternativen
gray_dilationgray_dilationGrayDilationGrayDilationGrayDilationgray_dilation,
gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect
Siehe auch
gray_opening_shapegray_opening_shapeGrayOpeningShapeGrayOpeningShapeGrayOpeningShapegray_opening_shape,
gray_closing_shapegray_closing_shapeGrayClosingShapeGrayClosingShapeGrayClosingShapegray_closing_shape,
gray_skeletongray_skeletonGraySkeletonGraySkeletonGraySkeletongray_skeleton
Modul
Foundation