Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of Contents

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 if pSrc or pDst is NULL.

ippStsSizeErr

Indicates an error if dstRoiSize has a field with a zero or negative value.

ippStsStepErr

Indicates an error if srcStep or dstStep has a zero or negative value.

ippStsWeightErr

Indicates an error if weight is less than or equal to 0.

ippStsEvenMedianWeight

Indicates a warning if weight has an even value.