Constructor

VipsImagemask_butterworth_band

Declaration [src] 

int
vips_mask_butterworth_band (
  VipsImage** out,
  int width,
  int height,
  double order,
  double frequency_cutoff_x,
  double frequency_cutoff_y,
  double radius,
  double amplitude_cutoff,
  ...
)

Description [src]

Optional arguments:

  • nodc: don’t set the DC pixel
  • reject: invert the filter sense
  • optical: coordinates in optical space
  • uchar: output a uchar image

Make an butterworth band-pass or band-reject filter, that is, one with a variable, smooth transition positioned at frequency_cutoff_x, frequency_cutoff_y, of radius radius. The shape of the curve is controlled by order —- higher values give a sharper transition. See Gonzalez and Wintz, Digital Image Processing, 1987.

See also: vips_mask_ideal().

This constructor is not directly available to language bindings.

Parameters

out

Type: VipsImage

Output image.

The argument will be set by the function.
The caller of the function takes ownership of the returned data, and is responsible for freeing it.
width

Type: int

Image size.

height

Type: int

Image size.

order

Type: double

Filter order.

frequency_cutoff_x

Type: double

Band position.

frequency_cutoff_y

Type: double

Band position.

radius

Type: double

Band radius.

amplitude_cutoff

Type: double

Amplitude threshold.

...

Type: 

NULL-terminated list of optional named arguments.

Return value

Type: int

0 on success, -1 on error.