Developer Reference

  • 2021
  • 03/26/2021
  • Public Content
Contents

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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.