vil_gauss_reduce.h File Reference

Functions to smooth and sub-sample image in one direction. More...

#include <vil/vil_image_view.h>
#include <vxl_config.h>

Go to the source code of this file.

Classes
class	vil_gauss_reduce_params

Functions
template<class T >
void	vil_gauss_reduce (const vil_image_view< T > &src, vil_image_view< T > &dest, vil_image_view< T > &work_im)
	Smooth and subsample src_im to produce dest_im. More...
template<class T >
void	vil_gauss_reduce_2_3 (const vil_image_view< T > &src_im, vil_image_view< T > &dest_im, vil_image_view< T > &work_im)
	Smooth and subsample src_im to produce dest_im (2/3 size). More...
template<class T >
void	vil_gauss_reduce_121 (const vil_image_view< T > &src, vil_image_view< T > &dest)
	Smooth and subsample src_im to produce dest_im. More...
template<class T >
void	vil_gauss_reduce_general (const vil_image_view< T > &src_im, vil_image_view< T > &dest_im, vil_image_view< T > &worka, vil_image_view< T > &workb, const vil_gauss_reduce_params &params)
	Smooth and subsample src_im by an arbitrary factor to produce dest_im. More...
template<class T >
void	vil_gauss_reduce_general (const vil_image_view< T > &src_im, vil_image_view< T > &dest_im, const vil_gauss_reduce_params &params)
	Smooth and subsample src_im by an arbitrary factor to produce dest_im. More...
template<class T >
void	vil_gauss_reduce_1plane (const T *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, T *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im. More...
template<>
void	vil_gauss_reduce_1plane (const vxl_byte *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, vxl_byte *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im. More...
template<>
void	vil_gauss_reduce_1plane (const float *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, float *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im. More...
template<>
void	vil_gauss_reduce_1plane (const int *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, int *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im. More...
template<>
void	vil_gauss_reduce_1plane (const double *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, double *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im. More...
template<>
void	vil_gauss_reduce_1plane (const vxl_int_16 *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, vxl_int_16 *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im. More...
template<class T >
void	vil_gauss_reduce_121_1plane (const T *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, T *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y. More...
template<>
void	vil_gauss_reduce_121_1plane (const vxl_byte *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, vxl_byte *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y. More...
template<>
void	vil_gauss_reduce_121_1plane (const float *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, float *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y. More...
template<>
void	vil_gauss_reduce_121_1plane (const int *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, int *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y. More...
template<>
void	vil_gauss_reduce_121_1plane (const double *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, double *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y. More...
template<>
void	vil_gauss_reduce_121_1plane (const vxl_int_16 *src_im, unsigned src_nx, unsigned src_ny, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, vxl_int_16 *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y. More...
template<class T >
void	vil_gauss_reduce_2_3_1plane (const T *src_im, unsigned src_ni, unsigned src_nj, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, T *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x, result is 2/3rd size. More...
template<>
void	vil_gauss_reduce_2_3_1plane (const vxl_byte *src_im, unsigned src_ni, unsigned src_nj, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, vxl_byte *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x, result is 2/3rd size. More...
template<>
void	vil_gauss_reduce_2_3_1plane (const int *src_im, unsigned src_ni, unsigned src_nj, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, int *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x, result is 2/3rd size. More...
template<>
void	vil_gauss_reduce_2_3_1plane (const vxl_int_16 *src_im, unsigned src_ni, unsigned src_nj, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, vxl_int_16 *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x, result is 2/3rd size. More...
template<>
void	vil_gauss_reduce_2_3_1plane (const float *src_im, unsigned src_ni, unsigned src_nj, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, float *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x, result is 2/3rd size. More...
template<>
void	vil_gauss_reduce_2_3_1plane (const double *src_im, unsigned src_ni, unsigned src_nj, std::ptrdiff_t s_x_step, std::ptrdiff_t s_y_step, double *dest_im, std::ptrdiff_t d_x_step, std::ptrdiff_t d_y_step)
	Smooth and subsample single plane src_im in x, result is 2/3rd size. More...

Detailed Description

Functions to smooth and sub-sample image in one direction.

Author

Tim Cootes Some of these are not templated because

• Each type tends to need a slightly different implementation
• Let's not have too many templates.

Amended by Martin Roberts 15th Sep 2005 Au contraire, let's have a generic template implementation after all The previous specific types one plane functions become template specialisations

Definition in file vil_gauss_reduce.h.

Function Documentation

vil_gauss_reduce()

template<class T >

void vil_gauss_reduce	(	const vil_image_view< T > &	src_im,
		vil_image_view< T > &	dest_im,
		vil_image_view< T > &	work_im
	)

Smooth and subsample src_im to produce dest_im.

Applies 1-5-8-5-1 smoothing filter in x and y, then samples every other pixel. work_im provides workspace

Applies filter in x and y, then samples every other pixel. work_im provides workspace

Definition at line 22 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_121()

template<class T >

void vil_gauss_reduce_121	(	const vil_image_view< T > &	src_im,
		vil_image_view< T > &	dest_im
	)

Smooth and subsample src_im to produce dest_im.

Applies 1-2-1 smoothing filter in x and y, then samples every other pixel.

Applies filter in x and y, then samples every other pixel.

Definition at line 97 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_121_1plane() [1/6]

template<class T >

void vil_gauss_reduce_121_1plane	(	const T *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		T *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y.

Smooths with a 3x3 filter and subsamples

Definition at line 331 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_121_1plane() [2/6]

template<>

void vil_gauss_reduce_121_1plane	(	const vxl_byte *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		vxl_byte *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y.

Smooths with a 3x3 filter and subsamples

Definition at line 446 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_121_1plane() [3/6]

template<>

void vil_gauss_reduce_121_1plane	(	const float *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		float *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y.

Smooths with a 3x3 filter and subsamples

Definition at line 518 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_121_1plane() [4/6]

template<>

void vil_gauss_reduce_121_1plane	(	const int *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		int *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y.

Smooths with a 3x3 filter and subsamples

Definition at line 662 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_121_1plane() [5/6]

template<>

void vil_gauss_reduce_121_1plane	(	const double *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		double *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y.

Smooths with a 3x3 filter and subsamples

Definition at line 590 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_121_1plane() [6/6]

template<>

void vil_gauss_reduce_121_1plane	(	const vxl_int_16 *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		vxl_int_16 *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im using 121 filter in x and y.

Smooths with a 3x3 filter and subsamples

Definition at line 734 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_1plane() [1/6]

template<class T >

void vil_gauss_reduce_1plane	(	const T *	src_im,
		unsigned	src_nx,
		unsigned	src_ny,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		T *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(nx+1)/2-1][0,ny-1] elements of dest Assumes dest_im has sufficient data allocated.

This is essentially a utility function, used by mil_gauss_pyramid_builder

By applying twice we can obtain a full gaussian smoothed and sub-sampled 2D image.

Definition at line 284 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_1plane() [2/6]

template<>

void vil_gauss_reduce_1plane	(	const vxl_byte *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		vxl_byte *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(nx+1)/2-1][0,ny-1] elements of dest Assumes dest_im has sufficient data allocated.

This is essentially a utility function, used by mil_gauss_pyramid_builder

By applying twice we can obtain a full gaussian smoothed and sub-sampled 2D image

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(ni+1)/2-1][0,nj-1] elements of dest

Definition at line 22 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_1plane() [3/6]

template<>

void vil_gauss_reduce_1plane	(	const float *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		float *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(nx+1)/2-1][0,ny-1] elements of dest Assumes dest_im has sufficient data allocated.

This is essentially a utility function, used by mil_gauss_pyramid_builder

By applying twice we can obtain a full gaussian smoothed and sub-sampled 2D image.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(ni+1)/2-1][0,nj-1] elements of dest

Definition at line 67 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_1plane() [4/6]

template<>

void vil_gauss_reduce_1plane	(	const int *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		int *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(nx+1)/2-1][0,ny-1] elements of dest Assumes dest_im has sufficient data allocated.

This is essentially a utility function, used by mil_gauss_pyramid_builder

By applying twice we can obtain a full gaussian smoothed and sub-sampled 2D image.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(ni+1)/2-1][0,nj-1] elements of dest

Definition at line 148 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_1plane() [5/6]

template<>

void vil_gauss_reduce_1plane	(	const double *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		double *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(ni+1)/2-1][0,nj-1] elements of dest

Definition at line 108 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_1plane() [6/6]

template<>

void vil_gauss_reduce_1plane	(	const vxl_int_16 *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		vxl_int_16 *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x to produce dest_im.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(nx+1)/2-1][0,ny-1] elements of dest Assumes dest_im has sufficient data allocated.

This is essentially a utility function, used by mil_gauss_pyramid_builder

By applying twice we can obtain a full gaussian smoothed and sub-sampled 2D image.

Applies 1-5-8-5-1 filter in x, then samples every other pixel. Fills [0,(ni+1)/2-1][0,nj-1] elements of dest

Definition at line 190 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_2_3()

template<class T >

void vil_gauss_reduce_2_3	(	const vil_image_view< T > &	src_im,
		vil_image_view< T > &	dest_im,
		vil_image_view< T > &	work_im
	)

Smooth and subsample src_im to produce dest_im (2/3 size).

Applies filter in x and y, then samples every other pixel. work_im provides workspace

Definition at line 60 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_2_3_1plane() [1/6]

template<class T >

void vil_gauss_reduce_2_3_1plane	(	const T *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		T *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x, result is 2/3rd size.

Applies alternate 1-3-1, 1-1 filter in x, then samples every other pixel. Fills [0,(2*ni+1)/3-1][0,nj-1] elements of dest

Note, 131 filter only an approximation

Definition at line 410 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_2_3_1plane() [2/6]

template<>

void vil_gauss_reduce_2_3_1plane	(	const vxl_byte *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		vxl_byte *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x, result is 2/3rd size.

Applies alternate 1-3-1, 1-1 filter in x, then samples every other pixel. Fills [0,(2*ni+1)/3-1][0,nj-1] elements of dest

Note, 131 filter only an approximation

Definition at line 319 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_2_3_1plane() [3/6]

template<>

void vil_gauss_reduce_2_3_1plane	(	const int *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		int *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x, result is 2/3rd size.

Applies alternate 1-3-1, 1-1 filter in x, then samples every other pixel. Fills [0,(2*ni+1)/3-1][0,nj-1] elements of dest

Note, 131 filter only an approximation

Definition at line 363 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_2_3_1plane() [4/6]

template<>

void vil_gauss_reduce_2_3_1plane	(	const vxl_int_16 *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		vxl_int_16 *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x, result is 2/3rd size.

Applies alternate 1-3-1, 1-1 filter in x, then samples every other pixel. Fills [0,(2*ni+1)/3-1][0,nj-1] elements of dest

Note, 131 filter only an approximation

Definition at line 406 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_2_3_1plane() [5/6]

template<>

void vil_gauss_reduce_2_3_1plane	(	const float *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		float *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x, result is 2/3rd size.

Applies alternate 1-3-1, 1-1 filter in x, then samples every other pixel. Fills [0,(2*ni+1)/3-1][0,nj-1] elements of dest

Note, 131 filter only an approximation

Definition at line 237 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_2_3_1plane() [6/6]

template<>

void vil_gauss_reduce_2_3_1plane	(	const double *	src_im,
		unsigned	src_ni,
		unsigned	src_nj,
		std::ptrdiff_t	s_x_step,
		std::ptrdiff_t	s_y_step,
		double *	dest_im,
		std::ptrdiff_t	d_x_step,
		std::ptrdiff_t	d_y_step
	)

Smooth and subsample single plane src_im in x, result is 2/3rd size.

Applies alternate 1-3-1, 1-1 filter in x, then samples every other pixel. Fills [0,(2*ni+1)/3-1][0,nj-1] elements of dest

Note, 131 filter only an approximation

Definition at line 278 of file vil_gauss_reduce.cxx.

vil_gauss_reduce_general() [1/2]

template<class T >

void vil_gauss_reduce_general	(	const vil_image_view< T > &	src_im,
		vil_image_view< T > &	dest_im,
		vil_image_view< T > &	worka,
		vil_image_view< T > &	workb,
		const vil_gauss_reduce_params &	params
	)

Smooth and subsample src_im by an arbitrary factor to produce dest_im.

Parameters

worka	provide workspace to avoid repetitive memory alloc and free
workb	provide workspace to avoid repetitive memory alloc and free

Definition at line 255 of file vil_gauss_reduce.hxx.

vil_gauss_reduce_general() [2/2]

template<class T >

void vil_gauss_reduce_general ( const vil_image_view< T > &  src_im, vil_image_view< T > &  dest_im, const vil_gauss_reduce_params &  params  )

inline

Smooth and subsample src_im by an arbitrary factor to produce dest_im.

Definition at line 110 of file vil_gauss_reduce.h.