im_freqflt(3)

im_freqflt3

Filters an image with a float filter mask in the frequency domain

Usage

#include <vips/vips.h>

int im_freqflt(in, filtermask, out)
IMAGE *in, *filtermask, *out;

Overview

im_freqflt() performs filtering in the frequency domain of the input image held by the image descriptor in with a mask held by the descriptor filtermask and writes the result on the image descriptor out.

Image sizes should be power of two and less or equal to 512. All images should be one channel square images. Image filtermask is a non-complex one channel image created by im_create_fmask(). Input image can be any type. If input is complex, in and filtermask are multiplied using the function im_cmultim(3).

If input is not complex then it is transformed into the frequency domain and then it is multiplied with the filtermask. In the latter case the result is inverse fourier transformed and clipped to the input image format using the function im_clip2fmt(3).

Return value

The function returns 0 on success and -1 on error.

Releases

Unchanged in 4 releases since Debian 3.1 (Sarge).

  1. 3.1–6.0

Bugs

The function has not been fully tested.

Author

N. Dessipris - 10/05/1991

From libvips-dev 7.20.7-1+b3 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.