FilterMinBorderReplicate

Applies the ‘min' filter with border replication to an image.

Syntax

IppStatus ippiFilterMinBorderReplicate_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, IppiSize maskSize, IppiPoint anchor, Ipp8u* pBuffer);

Supported values for mod:

8u_C1R	32f_C1R
8u_C3R	32f_C3R
8u_C4R	32f_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.
roiSize	Size of the source and destination ROI in pixels.
maskSize	Size of the mask in pixels.
anchor	Anchor cell specifying the mask alignment with respect to the position of the input pixel.
pBuffer	Pointer to the working buffer.

Description

The function ippiFilterMinBorderReplicate is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).

This function sets each pixel in the destination image to the minimum value of all the source image pixel values in the neighborhood of size maskSize with the anchor cell at that pixel. This has the effect of decreasing the contrast in the image.

The anchor cell is specified by its coordinates anchor.x and anchor.y in the coordinate system associated with the top left corner of the kernel. Border pixels are chosen according to Figure "Creating a Replicated Border". The function requires the external buffer pBuffer, its size should be computed by the function ippiFilterMinGetBufferSize beforehand.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr	Indicates an error condition if one of the specified pointers is NULL.
ippStsSizeErr	Indicates an error condition if roiSize or maskSize has a field with a zero or negative value.
ippStsStepErr	Indicates an error condition if srcStep or dstStep is less than roiSize.width * <pixelSize>.
ippStsNotEvenStepErr	Indicates an error condition if one of the step values is not divisible by 4 for floating-point images, or by 2 for short-integer images.
ippStsAnchorErr	Indicates an error if anchor is outside the mask.