FilterMedianWeightedCenter3x3
Filters an image using a median filter with a weighted center pixel.
Syntax
IppStatus ippiFilterMedianWeightedCenter3x3_8u_C1R(const Ipp8u*
pSrc
, int
srcStep
, Ipp8u*
pDst
, int
dstStep
, IppiSize
dstRoiSize
, int
weight
);
Include Files
ippi.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
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.
- weight
- Weight of the pixel, must be an odd number.
Description
This function 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 3x3 size with the anchor cell as the center cell of the mask. The parameter
weight
specifies the weight of the processed pixel, that is how many times its value is included into 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 operates on the assumption that the pixels outside of the source image ROI exist along the distance equal to half of 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 in Neighborhood Operations). The size of the source image ROI is equal to the size of the destination image ROI dstRoiSize
.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error ifpSrcorpDstisNULL.
- ippStsSizeErr
- Indicates an error ifdstRoiSizehas a field with a zero or negative value.
- ippStsStepErr
- Indicates an error ifsrcStepordstStephas a zero or negative value.
- ippStsWeightErr
- Indicates an error ifweightis less than or equal to 0.
- ippStsEvenMedianWeight
- Indicates a warning ifweighthas an even value.