Integration Wrappers for Intel® Integrated Performance Primitives Developer Guide and Reference 2019

API Quick Reference Guide

  • 2020
  • 09/30/2019
  • Public Content
Contents

iwiFilterGaussian

Syntax

IW_DECL_CPP(IppStatus) iwiFilterGaussian(
    const IwiImage                 &srcImage,                  
    IwiImage                       &dstImage,                 
    int                             kernelSize,                
    double                          sigma,                      
    const IwiFilterGaussianParams  &auxParams   = IwiFilterGaussianParams(),
    const IwiBorderType            &border      = ippBorderRepl,
    const IwiTile                  &tile        = IwiTile()          
);
Parameters
pSrcImage
Reference to the source image.
pDstImage
Reference to the destination image.
kernelSize
Size of the Gaussian filter kernel; must be odd and greater or equal to 3.
sigma
Standard deviation of the Gaussian kernel.
auxParams
Reference to the auxiliary parameters structure.
border
Extrapolation algorithm for out of image pixels processing. Supported values:
ippBorderConst
Values of all border pixels are set to a constant.
ippBorderRepl
Border is replicated from the edge pixels.
ippBorderMirror
Border pixels are mirrored from the source image boundary pixels.
ippBorderInMem
Border is obtained from the source image pixels in memory.
tile
Reference to the
IwiTile
 object for tiling. By default, no tiling is used.
Auxiliary Arguments
Argument
Default Value
Description
chDesc
iwiChDesc_None
Special channels processing mode.
Description
This function applies a Laplacian filter of the specified type and kernel size to the source image. The values of border pixels are assigned in accordance with the
border
 and
borderValue
 parameters.
Return Values
ippStsNoErr
No errors.
Exception Values
ippStsNotSupportedModeErr
Specified combination of parameters' values is not supported.
ippStsMaskSizeErr
The
kernel
 value is illegal.
ippStsDataTypeErr
The
dataType
 value is illegal.
ippStsNumChannelsErr
The
channels
 value is illegal.
ippStsNotEvenStepErr
The
srcStep
 and/or
dstStep
 value is not divisible by size of elements.
ippStsBorderErr
The
border
 value is illegal.
ippStsNoMemErr
Failed to allocate memory.
ippStsSizeErr
Values of the
size
 fields are illegal.
ippStsInplaceModeNotSupportedErr
In-place operation is not supported:
pSrc
 is equal to
pDst
.
ippStsNullPtrErr
At least one of the pointers (except
tile
) is
NULL
.

Product and Performance Information

1

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