Intel IPP Integration Wrappers Developer Guide and Reference

ID 751823
Date 1/18/2023
Public
Document Table of Contents

iwiFilterBox

Syntax

typedef struct _IwiFilterBoxParams
{
    IwiChDescriptor chDesc;
} IwiFilterBoxParams;
static IW_INLINE void iwiFilterBox_SetDefaultParams(
    IwiFilterBoxParams *pParams      
)
IW_DECL(IppStatus) iwiFilterBox(
    const IwiImage             *pSrcImage,      
    IwiImage                   *pDstImage,      
    IwiSize                     kernelSize,     
    const IwiFilterBoxParams   *pAuxParams,     
    IwiBorderType               border,         
    const Ipp64f               *pBorderVal,    
    const IwiTile              *pTile           
);

Parameters

pSrcImage

Pointer to the source image.

pDstImage

Pointer to the destination image.

kernelSize

Size of the filter kernel.

pAuxParams

Pointer to the auxiliary parameters structure. If NULL, default parameters are used.

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.

ippBorderInMem

Border is obtained from the source image pixels in memory.

ippBorderMirror

Border pixels are mirrored from the source image boundary pixels.

pBorderVal

Pointer to the array of constant values for ippBorderConst: one element for each channel. Can be NULL for any other border type.

pTile

Pointer to the IwiTile structure for tiling. If NULL, the whole image is processed.

Auxiliary Arguments

Argument Default Value Description

chDesc

iwiChDesc_None

Special channels processing mode.

Description

This function performs box filtering of an image.

This function supports the following features:

Feature Support
Data types 8u, 16u, 16s, 32f
Channel types C1, C3, C4, C4M1110
In-place mode No
64-bit sizes No
Internal threading No
Manual tiling Yes
IwsTile simple tiling Yes
IwsTile pipeline tiling Yes

Return Values

ippStsBorderErr

The border value is illegal.

ippStsDataTypeErr

The dataType value is illegal.

ippStsNumChannelsErr

The value for channels is illegal.

ippStsNotEvenStepErr

The step value is not divisible by size of elements.

ippStsNotSupportedModeErr

The selected function mode is not supported.

ippStsInplaceModeNotSupportedErr

In-place operation is not supported: pSrc is equal to pDst.

ippStsNullPtrErr

At least one of the pointers (except pTile) is NULL.

ippStsNoErr

No errors.