gen_std_bandpassgen_std_bandpassGenStdBandpassGenStdBandpassgen_std_bandpass (Operator)
Name
gen_std_bandpassgen_std_bandpassGenStdBandpassGenStdBandpassgen_std_bandpass — Erzeugen eines Bandpassfilter in der Form einer Gaußmaske oder
Sinusfunktion.
Signatur
Herror gen_std_bandpass(Hobject* ImageFilter, double Frequency, double Sigma, const char* Type, const char* Norm, const char* Mode, const Hlong Width, const Hlong Height)
Herror T_gen_std_bandpass(Hobject* ImageFilter, const Htuple Frequency, const Htuple Sigma, const Htuple Type, const Htuple Norm, const Htuple Mode, const Htuple Width, const Htuple Height)
void GenStdBandpass(HObject* ImageFilter, const HTuple& Frequency, const HTuple& Sigma, const HTuple& Type, const HTuple& Norm, const HTuple& Mode, const HTuple& Width, const HTuple& Height)
void HImage::GenStdBandpass(double Frequency, double Sigma, const HString& Type, const HString& Norm, const HString& Mode, Hlong Width, Hlong Height)
void HImage::GenStdBandpass(double Frequency, double Sigma, const char* Type, const char* Norm, const char* Mode, Hlong Width, Hlong Height)
void HImage::GenStdBandpass(double Frequency, double Sigma, const wchar_t* Type, const wchar_t* Norm, const wchar_t* Mode, Hlong Width, Hlong Height)
(Nur Windows)
static void HOperatorSet.GenStdBandpass(out HObject imageFilter, HTuple frequency, HTuple sigma, HTuple type, HTuple norm, HTuple mode, HTuple width, HTuple height)
void HImage.GenStdBandpass(double frequency, double sigma, string type, string norm, string mode, int width, int height)
Beschreibung
gen_std_bandpassgen_std_bandpassGenStdBandpassGenStdBandpassGenStdBandpassgen_std_bandpass erzeugt einen rotationsinvarianten
Bandpassfilter, dessen Bandpassverhalten und durch zugehörige
Parameter FrequencyFrequencyFrequencyFrequencyfrequencyfrequency und SigmaSigmaSigmaSigmasigmasigma beschrieben werden:
FrequencyFrequencyFrequencyFrequencyfrequencyfrequency legt den Abstand vom Nullpunkt und SigmaSigmaSigmaSigmasigmasigma
die Ausdehnung fest. FrequencyFrequencyFrequencyFrequencyfrequencyfrequency und SigmaSigmaSigmaSigmasigmasigma werden
als Bruchteil der maximalen (horizontalen und vertikalen) Frequenz,
die in einem Bild der Größe WidthWidthWidthWidthwidthwidth x
HeightHeightHeightHeightheightheight möglich ist, angegeben. FrequencyFrequencyFrequencyFrequencyfrequencyfrequency sollten
zwischen 0 und 1 liegen. Bei TypeTypeTypeTypetypetype = 'gauss'"gauss""gauss""gauss""gauss""gauss" wird
eine Gaußfunktion erzeugt. SigmaSigmaSigmaSigmasigmasigma ist dabei die
Standardabweichung. Bei TypeTypeTypeTypetypetype = 'sin'"sin""sin""sin""sin""sin" wird eine
Sinusfunktion mit dem Maximum bei FrequencyFrequencyFrequencyFrequencyfrequencyfrequency und der
Ausdehnung SigmaSigmaSigmaSigmasigmasigma berechnet. Um eine maximale Effizienz der
gesamten Filterung zu erreichen, kann mit NormNormNormNormnormnorm der
Normierungsfaktor des Filters festgelegt werden. Somit kann eine
Normierung in der FFT unterbleiben, falls fft_genericfft_genericFftGenericFftGenericFftGenericfft_generic
verwendet wird, falls NormNormNormNormnormnorm = 'n'"n""n""n""n""n" verwendet wird.
Mit ModeModeModeModemodemode kann festgelegt werden, wo der Nullfrequenz der
FFT liegen soll bzw. ob der Filter für die reelle FFT erzeugt
werden soll. Falls fft_genericfft_genericFftGenericFftGenericFftGenericfft_generic verwendet wird, kann zur
Effizienzsteigerung 'dc_edge'"dc_edge""dc_edge""dc_edge""dc_edge""dc_edge" verwendet werden. Falls
fft_imagefft_imageFftImageFftImageFftImagefft_image und fft_image_invfft_image_invFftImageInvFftImageInvFftImageInvfft_image_inv zur Filterung verwendet
werden, muss NormNormNormNormnormnorm = 'none'"none""none""none""none""none" und ModeModeModeModemodemode =
'dc_center'"dc_center""dc_center""dc_center""dc_center""dc_center" verwendet werden. Falls rft_genericrft_genericRftGenericRftGenericRftGenericrft_generic
verwendet wird, muss ModeModeModeModemodemode = 'rft'"rft""rft""rft""rft""rft" verwendet
werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ImageFilterImageFilterImageFilterImageFilterimageFilterimage_filter (output_object) image → objectHImageHObjectHImageHobject * (real)
Bandpassfilter als Bild in Frequenzraum.
FrequencyFrequencyFrequencyFrequencyfrequencyfrequency (input_control) real → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Abstand des Filtermaximums vom Mittelpunkt.
Defaultwert: 0.1
Wertevorschläge: 0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0
Restriktion: Frequency >= 0
SigmaSigmaSigmaSigmasigmasigma (input_control) real → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Bandbreite der Filters (Standardabweichung).
Defaultwert: 0.01
Wertevorschläge: 0.002, 0.005, 0.01, 0.02, 0.05, 0.1, 0.2, 0.3, 0.4, 0.5, 0.7, 1.0
Restriktion: Sigma >= 0
TypeTypeTypeTypetypetype (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Art des Filters.
Defaultwert:
'sin'
"sin"
"sin"
"sin"
"sin"
"sin"
Werteliste: 'gauss'"gauss""gauss""gauss""gauss""gauss", 'sin'"sin""sin""sin""sin""sin"
NormNormNormNormnormnorm (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Normierung des Filters.
Defaultwert:
'none'
"none"
"none"
"none"
"none"
"none"
Werteliste: 'n'"n""n""n""n""n", 'none'"none""none""none""none""none"
ModeModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Position der Nullfrequenz im Frequenzraum.
Defaultwert:
'dc_center'
"dc_center"
"dc_center"
"dc_center"
"dc_center"
"dc_center"
Werteliste: 'dc_center'"dc_center""dc_center""dc_center""dc_center""dc_center", 'dc_edge'"dc_edge""dc_edge""dc_edge""dc_edge""dc_edge", 'rft'"rft""rft""rft""rft""rft"
WidthWidthWidthWidthwidthwidth (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Breite des Bildes (Filters).
Defaultwert: 512
Wertevorschläge: 128, 160, 192, 256, 320, 384, 512, 640, 768, 1024, 2048, 4096, 8192
HeightHeightHeightHeightheightheight (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Höhe des Bildes (Filters).
Defaultwert: 512
Wertevorschläge: 120, 128, 144, 240, 256, 288, 480, 512, 576, 1024, 2048, 4096, 8192
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
gen_std_bandpassgen_std_bandpassGenStdBandpassGenStdBandpassGenStdBandpassgen_std_bandpass den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Vorgänger
fft_imagefft_imageFftImageFftImageFftImagefft_image,
fft_genericfft_genericFftGenericFftGenericFftGenericfft_generic,
rft_genericrft_genericRftGenericRftGenericRftGenericrft_generic
Nachfolger
convol_fftconvol_fftConvolFftConvolFftConvolFftconvol_fft
Alternativen
gen_sin_bandpassgen_sin_bandpassGenSinBandpassGenSinBandpassGenSinBandpassgen_sin_bandpass
Siehe auch
fft_image_invfft_image_invFftImageInvFftImageInvFftImageInvfft_image_inv,
gen_gauss_filtergen_gauss_filterGenGaussFilterGenGaussFilterGenGaussFiltergen_gauss_filter,
gen_mean_filtergen_mean_filterGenMeanFilterGenMeanFilterGenMeanFiltergen_mean_filter,
gen_derivative_filtergen_derivative_filterGenDerivativeFilterGenDerivativeFilterGenDerivativeFiltergen_derivative_filter,
gen_bandpassgen_bandpassGenBandpassGenBandpassGenBandpassgen_bandpass,
gen_bandfiltergen_bandfilterGenBandfilterGenBandfilterGenBandfiltergen_bandfilter,
gen_highpassgen_highpassGenHighpassGenHighpassGenHighpassgen_highpass,
gen_lowpassgen_lowpassGenLowpassGenLowpassGenLowpassgen_lowpass
Modul
Foundation