FilterILSInit

Initializes the filter specification structure.

Syntax

IppStatus ippiFilterILSInit (IppiFilterILSType filter, IppiSize dstRoiSize, IppDataType dataType, int numChannels, Ipp64f lambda, Ipp64f eps, Ipp64f pow, Ipp64f gamma, IppiFilterILSSpec* pSpec, Ipp8u* pBufInit);

Include Files

ippi.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

filter	Filter type: Norm or Welsch.
dataType	Data type flavors.
dstRoiSize	Size of the source and destination ROI in pixels.
numChannels	Number of channels.
pSpecSize	Pointer to the size (in bytes) of the specification structure.
pBufInitSize	Pointer to the size (in bytes) of the init temp buffer.
pBufferSize	Pointer to the size (in bytes) of the work buffer.
lambda	Lambda for Norm and Welsch.
eps	Eps for Norm.
pow	P for Norm.
gamma	Gamma for Welsch.
pSpec	Pointer to the specification structure.
pBufInit	Pointer to the buffer for init function.

Description

This function initializes the filter specification structure pSpec in the work buffer.

Before using this function, you need to compute the size of the specification structure using the ippiFilterILSGetBufferSize function. This structure is used by the ippiFilterILS function that performs edge-preserving image smoothing via Iterative Least Squares algorithm.

The ippiFilterILSInit function takes the following parameters: lambda, eps, p, gamma with values that are described in the article "Real-time Image Smoothing via Iterative Least Squares. Wei Liu, Pingping Zhang, Xiaolin Huang, Jie Yang, Chunhua Shen, Ian Reid". Link to the publication: https://arxiv.org/abs/2003.07504.

Use the ippiFilterILSGetBufferSize function to allocate the work buffer pBuffer and pBufInit.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error.
ippStsNullPtrErr	Indicates an error condition if any of the specified pointers is NULL.
ippStsStepErr	Indicates an error condition if one of the steps has a zero or negative value.
ippStsSizeErr	Indicates an error condition if one of the fields of dstRoiSize has a zero or negative value.