Filters an image using a median filter with weighted center pixel.
IppStatus ippiFilterMedianWeightedCenter3x3_8u_C1R(const Ipp8u* pSrc, int srcStep, Ipp8u* pDst, int dstStep, IppiSize dstRoiSize, int weight);
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. |
weight |
Weight of the pixel, must be an odd number. |
The function ippiFilterMedianWeightedCenter3x3 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 destination image as the median value of all the input pixel values taken in the neighborhood of the processed pixel. The neighborhood is determined by the fixed square mask of the size 3x3 with the anchor cell is the center cell of the mask. The parameter weight specifes the weight of the processed pixel, that is how many times its value will be included in the calculations. The value of this parameter should be odd. If it is even the function changes its value to the nearest less odd number and returns the warning message.
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. |
ippStsWeightErr |
Indicates an error condition if weight is less than or equal to 0. |
ippStsEvenMedianWeight |
Indicates a warning if weight has an even value. |
Copyright © 2000 - 2010, Intel Corporation. All rights reserved.