HALCON Website / HALCON Operator-Referenz / Filter / Glättung
KlassenKlassen | | Operatoren

mean_spmean_spMeanSpMeanSp (Operator)

Name

mean_spmean_spMeanSpMeanSp — Unterdrückung von Salz- und Pfeffer-Rauschen.

Signatur

mean_sp(Image : ImageSPMean : MaskWidth, MaskHeight, MinThresh, MaxThresh : )

Herror mean_sp(const Hobject Image, Hobject* ImageSPMean, const Hlong MaskWidth, const Hlong MaskHeight, const Hlong MinThresh, const Hlong MaxThresh)

Herror T_mean_sp(const Hobject Image, Hobject* ImageSPMean, const Htuple MaskWidth, const Htuple MaskHeight, const Htuple MinThresh, const Htuple MaxThresh)

void MeanSp(const HObject& Image, HObject* ImageSPMean, const HTuple& MaskWidth, const HTuple& MaskHeight, const HTuple& MinThresh, const HTuple& MaxThresh)

HImage HImage::MeanSp(Hlong MaskWidth, Hlong MaskHeight, Hlong MinThresh, Hlong MaxThresh) const

static void HOperatorSet.MeanSp(HObject image, out HObject imageSPMean, HTuple maskWidth, HTuple maskHeight, HTuple minThresh, HTuple maxThresh)

HImage HImage.MeanSp(int maskWidth, int maskHeight, int minThresh, int maxThresh)

Beschreibung

mean_spmean_spMeanSpMeanSpMeanSp führt eine Glättung durch Mittelwertbildung durch. Dabei gehen nur die Grauwerte in die Mittelung mit ein, die in dem Intervall von MinThreshMinThreshMinThreshMinThreshminThresh bis MaxThreshMaxThreshMaxThreshMaxThreshmaxThresh liegen. Zu helle oder zu dunkle Grauwerte werden bei der Summation ignoriert. Liegt kein Grauwert bei der Summation innerhalb des vorgegebenen Intervalls, so wird der Originalgrauwert übernommen. Setzt man die Schwellen auf 0 bzw. 255 so verhält sich mean_spmean_spMeanSpMeanSpMeanSp, abgesehen von der Laufzeit, wie mean_imagemean_imageMeanImageMeanImageMeanImage.

mean_spmean_spMeanSpMeanSpMeanSp wird verwendet um extreme Grauwerte (Salz- und Pfeffer-Rauschen = weiße und schwarze Punkte) zu unterdrücken.

Das Konzept der Glättungsfilter ist in der Einleitung zum Kapitel Filter / Glättung beschrieben.

Achtung

Werden für MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight oder MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth 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

Parameter

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) → objectHImageHImageHobject (byte / uint2)

Eingabebild.

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

Geglättetes Bild.

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x → HTupleHTupleHtuple (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 ≤ 512 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskWidth)

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y → HTupleHTupleHtuple (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 ≤ 512 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskHeight)

MinThreshMinThreshMinThreshMinThreshminThresh (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Mindestgrauwert.

Defaultwert: 1

Wertevorschläge: 1, 5, 7, 9, 11, 15, 23, 31, 43, 61, 101

MaxThreshMaxThreshMaxThreshMaxThreshmaxThresh (input_control)  integer → HTupleHTupleHtuple (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)
mean_sp(Image,ImageMeansp,3,3,101,201)
dev_display(ImageMeansp)

Beispiel (C)

read_image(&Image,"mreut");
disp_image(Image,WindowHandle);
mean_sp(Image,&ImageMeansp,3,3,101,201);
disp_image(ImageMeansp,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'mreut')
dev_display(Image)
mean_sp(Image,ImageMeansp,3,3,101,201)
dev_display(ImageMeansp)

Beispiel (HDevelop)

read_image(Image,'mreut')
dev_display(Image)
mean_sp(Image,ImageMeansp,3,3,101,201)
dev_display(ImageMeansp)

Beispiel (HDevelop)

read_image(Image,'mreut')
dev_display(Image)
mean_sp(Image,ImageMeansp,3,3,101,201)
dev_display(ImageMeansp)

Nachfolger

disp_imagedisp_imageDispImageDispImageDispImage

Alternativen

mean_imagemean_imageMeanImageMeanImageMeanImage, median_imagemedian_imageMedianImageMedianImageMedianImage, median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparate, eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMax

Siehe auch

anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusion, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImage, binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImage, eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMax

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH