Developer Reference for Intel® Integrated Performance Primitives 2018
Apply the filter to image columns.
Case 1: Operation on integer data
IppStatus ippiFilterColumnPipeline_<mod>(const Ipp<srcDatatype>** ppSrc, Ipp<dstDatatype>* pDst, int dstStep, IppiSize roiSize, const Ipp<srcDatatype>* pKernel, int kernelSize, int divisor, Ipp8u* pBuffer);
Supported values for mod:
16s_C1R | 16s8u_C1R | 16s8s_C1R | 16u_C1R |
16s_C3R | 16s8u_C3R | 16s8s_C3R | 16u_C3R |
IppStatus ippiFilterColumnPipeline_Low_16s_C1R(const Ipp16s** ppSrc, Ipp16s* pDst, int dstStep, IppiSize roiSize, const Ipp16s* pKernel, int kernelSize, int divisor, Ipp8u* pBuffer);
IppStatus ippiFilterColumnPipeline_Low_16s_C3R(const Ipp16s** ppSrc, Ipp16s* pDst, int dstStep, IppiSize roiSize, const Ipp16s* pKernel, int kernelSize, int divisor, Ipp8u* pBuffer);
Case 2: Operation on floating-point data
IppStatus ippiFilterColumnPipeline_<mod>(const Ipp<datatype>** ppSrc, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, const Ipp<datatype>* pKernel, int kernelSize, Ipp8u* pBuffer);
Supported values for mod:
32f_C1R |
32f_C3R |
ippcv.h
Headers: ippcore.h, ippvm.h, ipps.h, ippi.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib
ppSrc |
Double pointer to the source image ROI. |
pDst |
Pointer to the destination image ROI. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image. |
roiSize |
Size of the destination ROI in pixels. |
pKernel |
Pointer to the strow kernel values. |
kernelSize |
Size of the kernel in pixels. |
divisor |
Value by which the computed result is divided (for operations on integer data only). |
pBuffer |
Pointer to the working buffer. |
This function operates with ROI (see Regions of Interest in Intel IPP).
The function ippiFilterColumnPipeline_Low performs calculation exclusively with the 16s-data, and the input data must be in the range ensuring that the overflow does not occur during calculation and the result can be represented by a 32-bit integer number.
These functions apply the column filter of the separable convolution kernel to the source image pSrc. The filter coefficients are placed in the reversed order. For integer data:
and for floating point data:
Here j = 0, ... roiSize.width-1, i=0,... roiSize.height-1.
The size of the source image is
(roiSize.height + kernelSize - 1) * roiSize.width.
The functions requires the external buffer pBuffer, its size should be previously computed by the functions ippiFilterColumnPipelineGetBufferSize and ippiFilterColumnPipelineGetBufferSize_Low respectively.
ippStsNoErr |
Indicates no error. Any other value indicates an error. |
ippStsNullPtrErr |
Indicates an error condition if one of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition if roiSize has a field with a zero or negative value. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep is less than roiSize.width * <pixelSize> |
ippStsNotEvenStepErr |
Indicates an error condition if one of the step values is not divisible by 4 for floating-point images, or by 2 for short-integer images. |
ippStsBadArgErr |
Indicates an error condition if divisor is equal to 0. |