eliminate_speliminate_spEliminateSpEliminateSpeliminate_sp (Operator)
Name
eliminate_speliminate_spEliminateSpEliminateSpeliminate_sp — Ersetzen der Werte außerhalb der Schwellen durch den Mittelwert.
Signatur
Herror eliminate_sp(const Hobject Image, Hobject* ImageFillSP, const Hlong MaskWidth, const Hlong MaskHeight, const Hlong MinThresh, const Hlong MaxThresh)
Herror T_eliminate_sp(const Hobject Image, Hobject* ImageFillSP, const Htuple MaskWidth, const Htuple MaskHeight, const Htuple MinThresh, const Htuple MaxThresh)
Beschreibung
eliminate_speliminate_spEliminateSpEliminateSpEliminateSpeliminate_sp ersetzt alle Grauwerte außerhalb des
angegebenen Grauwertintervalls (MinThreshMinThreshMinThreshMinThreshminThreshmin_thresh bis
MaxThreshMaxThreshMaxThreshMaxThreshmaxThreshmax_thresh) durch den Mittelwert der Nachbarn. Es werden
für die Mittlung aber nur die Nachbarpunkte herangezogen, die
ebenfalls innerhalb des Grauwertintervalls liegen. Ist in der
Umgebung kein solcher Punkt enthalten, wird der Originalgrauwert
verwendet. Die Grauwerte im Eingabebild, die innerhalb des
Grauwertintervalls liegen, werden ebenfalls unverändert
übernommen.
Das Konzept der Glättungsfilter ist in der Einleitung zum Kapitel
Filter / Glättung beschrieben.
Achtung
Werden für MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height oder MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width gerade
statt ungerade Werte übergeben, verwendet die Routine an ihrer
Stelle die nächstgrößeren ungeraden Werte (damit ist der
Schwerpunkt der Filtermaske immer eindeutig bestimmt).
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
- 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)
Eingabebild.
ImageFillSPImageFillSPImageFillSPImageFillSPimageFillSPimage_fill_sp (output_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject * (byte / uint2)
Geglättetes Bild.
MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Breite der Filtermaske.
Defaultwert: 3
Wertevorschläge: 3, 5, 7, 9, 11
Typischer Wertebereich: 3
≤
MaskWidth
MaskWidth
MaskWidth
MaskWidth
maskWidth
mask_width
(lin)
Minimale Schrittweite: 2
Empfohlene Schrittweite: 2
Restriktion: odd(MaskWidth) && MaskWidth < width(Image) * 2
MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control) extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Höhe der Filtermaske.
Defaultwert: 3
Wertevorschläge: 3, 5, 7, 9, 11
Typischer Wertebereich: 3
≤
MaskHeight
MaskHeight
MaskHeight
MaskHeight
maskHeight
mask_height
(lin)
Minimale Schrittweite: 2
Empfohlene Schrittweite: 2
Restriktion: odd(MaskHeight) && MaskHeight < height(Image) * 2
MinThreshMinThreshMinThreshMinThreshminThreshmin_thresh (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Mindestgrauwert.
Defaultwert: 1
Wertevorschläge: 1, 5, 7, 9, 11, 15, 23, 31, 43, 61, 101
MaxThreshMaxThreshMaxThreshMaxThreshmaxThreshmax_thresh (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Maximalgrauwert.
Defaultwert: 254
Wertevorschläge: 5, 7, 9, 11, 15, 23, 31, 43, 61, 101, 200, 230, 250, 254
Restriktion: MinThresh <= MaxThresh
Beispiel (HDevelop)
read_image(Image,'mreut')
dev_display(Image)
eliminate_sp(Image,ImageFillSP,3,3,101,201)
dev_display(ImageFillSP)
Beispiel (C)
read_image(&Image,"mreut");
disp_image(Image,WindowHandle);
eliminate_sp(Image,&ImageFillSP,3,3,101,201);
disp_image(ImageFillSP,WindowHandle);
Beispiel (HDevelop)
read_image(Image,'mreut')
dev_display(Image)
eliminate_sp(Image,ImageFillSP,3,3,101,201)
dev_display(ImageFillSP)
Beispiel (HDevelop)
read_image(Image,'mreut')
dev_display(Image)
eliminate_sp(Image,ImageFillSP,3,3,101,201)
dev_display(ImageFillSP)
Beispiel (HDevelop)
read_image(Image,'mreut')
dev_display(Image)
eliminate_sp(Image,ImageFillSP,3,3,101,201)
dev_display(ImageFillSP)
Nachfolger
disp_imagedisp_imageDispImageDispImageDispImagedisp_image
Alternativen
mean_spmean_spMeanSpMeanSpMeanSpmean_sp,
mean_imagemean_imageMeanImageMeanImageMeanImagemean_image,
median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image,
eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMaxeliminate_min_max
Siehe auch
binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter,
gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter,
smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImagesmooth_image,
anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusionanisotropic_diffusion,
sigma_imagesigma_imageSigmaImageSigmaImageSigmaImagesigma_image,
eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMaxeliminate_min_max
Modul
Foundation