Operator Reference

HALCON Operator Reference / Filters / FFT
ClassesClasses | | Operators

fft_imagefft_imageFftImageFftImagefft_image (Operator)

fft_imagefft_imageFftImageFftImagefft_image — Compute the fast Fourier transform of an image.

Signature

fft_image(Image : ImageFFT : : )

Herror fft_image(const Hobject Image, Hobject* ImageFFT)

Herror T_fft_image(const Hobject Image, Hobject* ImageFFT)

void FftImage(const HObject& Image, HObject* ImageFFT)

HImage HImage::FftImage() const

static void HOperatorSet.FftImage(HObject image, out HObject imageFFT)

HImage HImage.FftImage()

def fft_image(image: HObject) -> HObject

Description

fft_imagefft_imageFftImageFftImagefft_image calculates the Fourier transform of the input image (ImageImageImageimageimage), i.e., it transforms the image into the frequency domain. The algorithm used is the fast Fourier transform. This corresponds to the call fft_generic(Image,ImageFFT,'to_freq',-1,'sqrt','dc_center','complex')fft_generic(Image,ImageFFT,"to_freq",-1,"sqrt","dc_center","complex")FftGeneric(Image,ImageFFT,"to_freq",-1,"sqrt","dc_center","complex")FftGeneric(Image,ImageFFT,"to_freq",-1,"sqrt","dc_center","complex")fft_generic(Image,ImageFFT,"to_freq",-1,"sqrt","dc_center","complex").

Attention

The transformation is always performed for the entire image, i.e., the domain of the image is ignored.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.
  • Automatically parallelized on channel level.
  • Automatically parallelized on internal data level.

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / real)

Input image.

ImageFFTImageFFTImageFFTimageFFTimage_fft (output_object)  image(-array) → objectHImageHObjectHObjectHobject * (complex)

Fourier-transformed image.

Result

fft_imagefft_imageFftImageFftImagefft_image returns 2 ( H_MSG_TRUE) if the input image is of correct type. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedoptimize_fft_speed, read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data

Possible Successors

convol_fftconvol_fftConvolFftConvolFftconvol_fft, convol_gaborconvol_gaborConvolGaborConvolGaborconvol_gabor, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type, power_bytepower_bytePowerBytePowerBytepower_byte, power_realpower_realPowerRealPowerRealpower_real, power_lnpower_lnPowerLnPowerLnpower_ln, phase_degphase_degPhaseDegPhaseDegphase_deg, phase_radphase_radPhaseRadPhaseRadphase_rad

Alternatives

fft_genericfft_genericFftGenericFftGenericfft_generic, rft_genericrft_genericRftGenericRftGenericrft_generic

See also

fft_image_invfft_image_invFftImageInvFftImageInvfft_image_inv

Module

Foundation

ClassesClasses | | Operators