gen_filter

Herror ::gen_filter_mask ( Hobject *ImageFilter, const HTuple &FileName, const HTuple &Scale, const HTuple &Size ) HImage HImage::GenFilterMask ( const HTuple &FileName, const HTuple &Scale, const HTuple &Size ) HImageArray HImageArray::GenFilterMask ( const HTuple &FileName, const HTuple &Scale, const HTuple &Size )

Store a filter mask in the spatial domain as a real-image.

::gen_filter_mask stores a filter mask in the spatial domain as a real-image. The center of the filter mask lies in the center of the resulting image. The parameter Scale determines by which amount the values of the filter mask are multiplied (this results in larger values of the Fourier transform of the filter). The file format of the filter mask file is described with the operator ::convol_image. Example filter masks can be found in the directory ``filter'' in the HALCON home directory. This operator is useful for visualizing the frequency response of filter masks (by applying a Fourier transform to the result image of this operator).

Parameters

`ImageFilter` (output_object)	image(-array) `->` Hobject : HImage(Array)* ( real )
Filter in the spatial domain.

`FileName` (input_control)	string `->` HTuple.char *
File name of the filter mask.
Default value: 'sobel'
Suggested values: 'laplace4', 'laplace8', 'lowpass_3_3'

`Scale` (input_control)	real `->` HTuple.double
Scaling factor.
Default value: 1.0
Suggested values: 0.3, 0.5, 0.75, 1.0, 1.25, 1.5, 2.0
Typical range of values: `0.001 <= Scale <= 10.0`
Minimum increment: 0.001
Recommended increment: 0.1
Restriction: `Scale > 0.0`

`Size` (input_control)	integer `->` HTuple.long
Size (dimension) of the image (filter).
Default value: 512
List of values: 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192

Example

gen_filter_mask(&Filter,"lowpass_3_3",1.0,512);
fft_image(Filter,&FilterFFT);
set_paint(WindowHandle,"3D-plot_hidden");
disp_image(FilterFFT,WindowHandle);

Possible Successors

::fft_image, ::fft_generic

See also

::convol_image

Module

Image filters