convol_fft ( ImageFFT, ImageFilter : ImageConvol : : )

Convolve an image with a filter in the frequency domain.

convol_fft convolves two (Fourier-transformed) images in the frequency domain, i.e., the pixels of the complex image ImageFFT are multiplied by the corresponding pixels of the filter ImageFilter.


Attention

The filtering is always done on the entire image, i.e., the region of the image is ignored.


Parameters

ImageFFT (input_object)
image(-array) -> object : complex
Complex input image.

ImageFilter (input_object)
image -> object : real / complex
Filter in frequency domain.

ImageConvol (output_object)
image(-array) -> object : complex
Result of applying the filter.


Example
gen_highpass(Highpass,0.2,'n','dc_edge',Width,Height)
fft_generic(Image,ImageFFT,'to_freq',-1,'none','dc_edge','complex')
convol_fft(ImageFFT,Highpass:ImageConvol)
fft_generic(ImageConvol,ImageResult,'from_freq',1,'none','dc_edge','byte')

Result

convol_fft returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception handling is raised.


Parallelization Information

convol_fft is reentrant and automatically parallelized (on tuple level).


Possible Predecessors

fft_image, fft_generic, rft_generic, gen_highpass, gen_lowpass, gen_bandpass, gen_bandfilter


Possible Successors

power_byte, power_real, power_ln, fft_image_inv, fft_generic, rft_generic


Alternatives

convol_gabor


See also

gen_gabor, gen_highpass, gen_lowpass, gen_bandpass, convol_gabor, fft_image_inv


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH