Filters an image using a horizontal median filter.
IppStatus ippiFilterMedianHoriz_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiMaskSize mask);
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 |
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. |
mask |
Predefined mask of IppiMaskSize type. |
The function ippiFilterMedianHoriz is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function sets each pixel in the output buffer as the median value of all the input pixel values taken in the neighborhood of the processed pixel. The horizontal size of the neighborhood and the anchor cell coordinates depend on the mask mean, which can be either ippMskSize3x1 or ippMskSize5x1 (see Table “Median Filter Mask, Neighborhood, and Anchor Cell”). The function is used on the assumption that the pixels outside of the source image ROI exist along the distance of half the mask size. It means that the application program should provide appropriate values for the pSrc and dstRoiSize arguments, or define additional border pixels (see Borders). The size of the source image ROI is equal to dstRoiSize, the size of the destination image ROI.
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error condition if pSrc or pDst is NULL. |
ippStsSizeErr |
Indicates an error condition if dstRoiSize has a field with a zero or negative value. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep has a zero or negative value. |
ippStsMaskSizeErr |
Indicates an error condition if mask has an illegal value. |
Copyright © 2000 - 2011, Intel Corporation. All rights reserved.