FilterColumn32f

Filters an image with integer data using a floating-point column kernel.

Syntax

IppStatus ippiFilterColumn32f_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, const Ipp32f* pKernel, int kernelSize, int yAnchor);

Supported values for mod:

8u_C1R	16u_C1R	16s_C1R
8u_C3R	16u_C3R	16s_C3R
8u_C4R	16u_C4R	16s_C4R
8u_AC4R	16u_AC4R	16s_AC4R

Parameters

pSrc	Pointer to the source image ROI.
srcStep	Distance in bytes between starts of consecutive lines in the source image.
pDst	Pointer to the destination image ROI.
dstStep	Distance in bytes between starts of consecutive lines in the destination image.
dstRoiSize	Size of the source and destination ROI in pixels.
pKernel	Pointer to the column kernel values.
kernelSize	Size of the kernel in pixels.
yAnchor	Anchor cell specifying the kernel vertical alignment with respect to the position of the input pixel.

Description

The function ippiFilterColumn32f is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP).

This function uses the vertical column kernel of floating-point values to filter an image that consists of integer data. This function sums the products between the kernel coefficients pKernel and pixel values taken over the source pixel neighborhood defined by kernelSize and yAnchor. Note that kernel coefficients are used in inverse order. The sum is written to the destination pixel. The summation formula for computing result values is similar to that used by the ippiFilterColumn function, but no scaling of the result is done. To ensure valid operation when image boundary pixels are processed, the application should correctly define additional border pixels (see Borders).

Return Values

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 dstRoiSize has a field with a zero or negative value.