NAME

gauss_sample_image - Takes gaussian samples of an image

SYNOPSIS

#include "i/i_convolve.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int gauss_sample_image
(
	KJB_image **out_ipp,
	const KJB_image *in_ip,
	int resolution,
	double sigma
);

DESCRIPTION

This routine reduces image resolution by taking averages with Gaussian weights. The 'resolution' argument is equal to the linear shrinkage factor. For example, if resolution=3 then the output image will have one-third the number of rows and one-third the number of columns of the input image. This is also known as the decimation factor. The 'sigma' argument obviously controls the antialiasing kernel size. As a rule of thumb, the value of sigma should be around 0.5 to 1.0 times the value of resolution. If *out_ipp is NULL, then an image of the appropriate size is created, if it is the wrong size, then it is resized, and if it is the right size, the storage is recycled.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

ow_gauss_convolve_image , gauss_convolve_image , convolve_image , x_convolve_image , y_convolve_image