Filter32f

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

Syntax

IppStatus ippiFilter32f_<mod>(const Ipp<srcDatatype>* pSrc, int srcStep, Ipp<dstDatatype>* pDst, int dstStep, IppiSize dstRoiSize, const Ipp32f* pKernel, IppiSize kernelSize, IppiPoint anchor);

Supported values for mod:

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

8u16s_C1R	8s16s_C1R
8u16s_C3R	8s16s_C3R
8u16s_C4R	8s16s_C4R

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 kernel values.
kernelSize	Size of the rectangular kernel in pixels.
anchor	Anchor cell specifying the rectangular kernel alignment with respect to the position of the input pixel.

Description

The function ippiFilter32f is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP). This function uses the rectangular 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 anchor. The anchor cell is specified by its coordinates anchor.x and anchor.y in the coordinate system associated with the bottom right corner of the kernel. 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 ippiFilter function, but no scaling of the result is done. To ensure valid operation when image boundary pixels are processed, the application must 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 pSrc, pDst, or pKernel is NULL.
ippStsSizeErr	Indicates an error condition if dstRoiSize or kernelSize has a field with a zero or negative value.
ippStsStepErr	Indicates an error condition if one the step value is less than `roiSize.widthsizeof(pSrc)numberOfChannels`.