You are here: Start » Image » Image Local Transforms » SmoothImage_Deriche

SmoothImage_Deriche

Header:	FIL.h
Namespace:	fil

Smooths an image using Deriche filter.

Applications: Approximation of the gaussian filter, which can be faster for large kernels.

Syntax

void fil::SmoothImage_Deriche
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	const float inAlphaX,
	ftl::Optional<float> inAlphaY,
	fil::Image& outImage
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inRoi	Optional<const Region&>		NIL	Range of output pixels to be computed
inAlphaX	const float	0.001 -	0.5f	Horizontal coefficient
inAlphaY	Optional<float>	0.001 -	NIL	Vertical coefficient
outImage	Image&			Output image

Hints

To make smoothing stronger, decrease the inAlphaX and - optionally - inAlphaY.
If the smoothing kernel is not very big, it is recommended to use SmoothImage_Gauss instead.

Examples

SmoothImage_Deriche performed on a sample image with inAlphaX = 0.5.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type	Description
DomainError	Region exceeds an input image in SmoothImage_Deriche.