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. IfNULL, 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 forippBorderConst: one element for each channel. Can beNULLfor any other border type.
- pTile
- Pointer to theIwiTilestructure for tiling. IfNULL, 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
- Thebordervalue is illegal.
- ippStsDataTypeErr
- ThedataTypevalue 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:pSrcis equal topDst.
- ippStsNullPtrErr
- At least one of the pointers (exceptpTile) isNULL.
- ippStsNoErr
- No errors.