Developer Reference for Intel® Integrated Performance Primitives 2019
Filters an image using a horizontal Roberts edge filter.
IppStatus ippiFilterRobertsDownBorder_<mod>(const Ipp<srcDatatype>* pSrc, int srcStep, Ipp<dstDatatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiMaskSize mask, IppiBorderType borderType, Ipp<srcDatatype> borderValue, Ipp8u* pBuffer);
Supported values for mod:
8u16s_C1R | 16s_C1R | 32f_C1R |
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 the starting points of consecutive lines in the destination image. | ||||||||||
dstRoiSize |
Size of the source and destination ROI in pixels. | ||||||||||
mask |
Predefined mask of IppiMaskSize. Possible value is ippMskSize3x3. | ||||||||||
borderType |
Type of border. Possible values are:
Mixed borders are also supported. They can be obtained by the bitwise operation OR between any of the ippBorderRepl, ippBorderConst, ippBorderMirror, or ippBorderMirrorR values, and the ippBorderInMemTop, ippBorderInMemBottom, ippBorderInMemLeft, ippBorderInMemRight values. |
||||||||||
borderValue |
Constant value to assign to pixels of the constant border. This parameter is applicable only to the ippBorderConst border type. | ||||||||||
pBuffer |
Pointer to the work buffer. |
Before using this function, you need to compute the size of the work buffer pBuffer using the FilterRobertsDownBorderGetBufferSize function.
This function operates with ROI.
This function applies a horizontal Roberts edge filter to the pSrc source image ROI. The size of the source image ROI is equal to the destination image ROI size dstRoiSize. The values of border pixels are assigned in accordance with the borderType and borderValue parameters. The kernel of the filter is a matrix of 3x3 size with the following values:
0 0 0
0 1 0
0 0 -1
The anchor cell is the center cell of the kernel, highlighted in red.
This filter provides the gross approximation of the pixel values gradient in the horizontal direction.
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error when dstRoiSize is negative, or equal to zero. |
ippStsStepErr |
Indicates an error when srcStep or dstStep is negative, or equal to zero. |
ippStsNotEvenStepErr |
Indicates an error when one of the step values is not divisible by 4 for floating-point images, or by 2 for short-integer images. |
ippStsBorderErr |
Indicates an error when borderType has an illegal value. |