Developer Reference for Intel® Integrated Performance Primitives 2019
Filters an image using a rectangular filter.
Case 1: Operation on one-channel data
IppStatus ippiFilterBorder_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiBorderType border, const Ipp<datatype> borderValue[1], const IppiFilterBorderSpec* pSpec, Ipp8u* pBuffer);
Supported values for mod:
8u_C1R |
16u_C1R |
16s_C1R |
32f_C1R |
64f_C1R |
Case 2: Operation on multi-channel data
IppStatus ippiFilterBorder_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiBorderType border, const Ipp<datatype> borderValue[3], const IppiFilterBorderSpec* pSpec, Ipp8u* pBuffer);
Supported values for mod:
8u_C3R |
16u_C3R |
16s_C3R |
32f_C3R |
IppStatus ippiFilterBorder_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiBorderType border, const Ipp<datatype> borderValue[4], const IppiFilterBorderSpec* pSpec, Ipp8u* pBuffer);
Supported values for mod:
8u_C4R |
16u_C4R |
16s_C4R |
32f_C4R |
ippi.h
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib
pSrc |
Pointer to the source image ROI. |
||||||
srcStep |
Distance, in bytes, between the starting points of consecutive lines in the source image. |
||||||
pDst |
Pointer to the destination image ROI. |
||||||
dstStep |
Distance, in bytes, between starting points of consecutive lines in the destination image. |
||||||
dstRoiSize |
Size of the source and destination image ROI in pixels. |
||||||
border |
Type of border. Possible values are:
Mixed borders are also supported. They can be obtained by the bitwise operation OR between the ippBorderRepl or ippBorderConst values and ippBorderInMemTop, ippBorderInMemBottom, ippBorderInMemLeft, ippBorderInMemRight. |
||||||
borderValue |
Constant value to assign to pixels of the constant border. This parameter is applicable only to the ippBorderConst border type. |
||||||
pSpec |
Pointer to the filter specification structure. |
||||||
pBuffer |
Pointer to the work buffer for filtering operations. |
Before using this function, you need to initialize the filter specification structure using the ippiFilterBorderInit function.
This function operates with ROI.
This function performs filtering of a rectangular ROI inside a two-dimensional image using a specified structure pSpec. Type of the image border is defined by the value of the border parameter.
To change the function behavior (add offset to the result or set the rounding mode), use ippiFilterBorderSetMode after the ippiFilterBorderInit function.
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error when dstRoiSize has a field with a zero or negative value, or if dstRoiSize.width is more than the maximum ROI roiWidth passed to the initialization function. |
ippStsStepErr |
Indicates an error when the srcStep value is less than, or equal to zero. |
ippStsBorderErr |
Indicates an error when border has an illegal value. |