HALCON Website / HALCON Operator-Referenz / Filter / FFT
KlassenKlassenKlassenKlassen | | | | Operatoren

gen_std_bandpassgen_std_bandpassGenStdBandpassgen_std_bandpassGenStdBandpassGenStdBandpass (Operator)

Name

gen_std_bandpassgen_std_bandpassGenStdBandpassgen_std_bandpassGenStdBandpassGenStdBandpass — Erzeugen eines Bandpassfilter in der Form einer Gaußmaske oder Sinusfunktion.

Signatur

gen_std_bandpass( : ImageFilter : Frequency, Sigma, Type, Norm, Mode, Width, Height : )

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)

Herror 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)

HImage HImage::GenStdBandpass(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 HOperatorSetX.GenStdBandpass(
[out] IHUntypedObjectX** ImageFilter, [in] VARIANT Frequency, [in] VARIANT Sigma, [in] VARIANT Type, [in] VARIANT Norm, [in] VARIANT Mode, [in] VARIANT Width, [in] VARIANT Height)

void HImageX.GenStdBandpass(
[in] double Frequency, [in] double Sigma, [in] BSTR Type, [in] BSTR Norm, [in] BSTR Mode, [in] Hlong Width, [in] Hlong Height)

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_bandpassGenStdBandpassgen_std_bandpassGenStdBandpassGenStdBandpass 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 verikalen) 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_genericFftGenericfft_genericFftGenericFftGeneric 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_genericFftGenericfft_genericFftGenericFftGeneric verwendet wird, kann zur Effizienzsteigerung 'dc_edge'"dc_edge""dc_edge""dc_edge""dc_edge""dc_edge" verwendet werden. Falls fft_imagefft_imageFftImagefft_imageFftImageFftImage und fft_image_invfft_image_invFftImageInvfft_image_invFftImageInvFftImageInv 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_genericRftGenericrft_genericRftGenericRftGeneric verwendet wird, muss ModeModeModeModeModemode = 'rft'"rft""rft""rft""rft""rft" verwendet werden.

Parallelisierung

Parameter

ImageFilterImageFilterImageFilterImageFilterImageFilterimageFilter (output_object)  image → objectHImageHImageHImageHImageXHobject * (real)

Bandpassfilter als Bild in Frequenzraum.

FrequencyFrequencyFrequencyFrequencyFrequencyfrequency (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (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 → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (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 → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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 → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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 → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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 → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Breite des Bildes (Filters).

Defaultwert: 512

Werteliste: 128, 160, 192, 256, 320, 384, 512, 640, 768, 1024, 2048, 4096, 8192

HeightHeightHeightHeightHeightheight (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Höhe des Bildes (Filters).

Defaultwert: 512

Werteliste: 120, 128, 144, 240, 256, 288, 480, 512, 576, 1024, 2048, 4096, 8192

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_std_bandpassgen_std_bandpassGenStdBandpassgen_std_bandpassGenStdBandpassGenStdBandpass den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

fft_imagefft_imageFftImagefft_imageFftImageFftImage, fft_genericfft_genericFftGenericfft_genericFftGenericFftGeneric, rft_genericrft_genericRftGenericrft_genericRftGenericRftGeneric

Nachfolger

convol_fftconvol_fftConvolFftconvol_fftConvolFftConvolFft

Alternativen

gen_sin_bandpassgen_sin_bandpassGenSinBandpassgen_sin_bandpassGenSinBandpassGenSinBandpass

Siehe auch

fft_image_invfft_image_invFftImageInvfft_image_invFftImageInvFftImageInv, gen_gauss_filtergen_gauss_filterGenGaussFiltergen_gauss_filterGenGaussFilterGenGaussFilter, gen_mean_filtergen_mean_filterGenMeanFiltergen_mean_filterGenMeanFilterGenMeanFilter, gen_derivative_filtergen_derivative_filterGenDerivativeFiltergen_derivative_filterGenDerivativeFilterGenDerivativeFilter, gen_bandpassgen_bandpassGenBandpassgen_bandpassGenBandpassGenBandpass, gen_bandfiltergen_bandfilterGenBandfiltergen_bandfilterGenBandfilterGenBandfilter, gen_highpassgen_highpassGenHighpassgen_highpassGenHighpassGenHighpass, gen_lowpassgen_lowpassGenLowpassgen_lowpassGenLowpassGenLowpass

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH