FloodFill

Performs flood filling of connected area.

Syntax

Case 1: Operations on one-channel data

IppStatus ippiFloodFill_4Con_<mod>(Ipp<datatype>* pImage, int imageStep, IppiSize roiSize, IppiPoint seed, Ipp<datatype> newVal, IppiConnectedComp* pRegion, Ipp8u* pBuffer);

IppStatus ippiFloodFill_8Con_<mod>(Ipp<DataType>* pImage, int imageStep, IppiSize roiSize, IppiPoint seed, Ipp<datatype> newVal, IppiConnectedComp* pRegion, Ipp8u* pBuffer);

Supported values for mod:

8u_C1IR

16u_C1IR

32f_C1IR

Case 2: Operations on three-channel data

IppStatus ippiFloodFill_4Con_<mod>(Ipp<datatype>* pImage, int imageStep, IppiSize roiSize, IppiPoint seed, Ipp<datatype>* pNewVal, IppiConnectedComp* pRegion, Ipp8u* pBuffer);

IppStatus ippiFloodFill_8Con_<mod>(Ipp<DataType>* pImage, int imageStep, IppiSize roiSize, IppiPoint seed, Ipp<datatype>* pNewVal, IppiConnectedComp* pRegion, Ipp8u* pBuffer);

Supported values for mod:

8u_C3IR

32f_C3IR

Parameters

pImage: Pointer to the ROI in the source and destination image (for the in-place operation).
imageStep: Distance in bytes between starts of consecutive lines in the image buffer.
roiSize: Size of the image ROI in pixels.
seed: Initial point.
newVal: Value to fill with for one-channel data.
pNewVal: Pointer to the vector containing values to fill with for three-channel data.
pRegion: Pointer to the connected components structure that stores information about the refilled area.
pBuffer: Pointer to the temporary buffer.

Description

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

This function performs flood filling of the group of connected pixels whose pixel values are equal to the value in the seed point. Values of these pixel is set to the newVal value.

The function requires a temporary buffer whose size should be computed with the function ippiFloodFillGetSize beforehand.

The functions with the “_4con” suffixes check 4-connected neighborhood of each pixel, that is, side neighbors. The functions with the “_8con” suffixes check 8-connected neighborhood of each pixel, that is, side and corner neighbors. See Figure Pixels Connectivity Patterns”.

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 has a field with zero or negative value.
ippStsStepErr	Indicates an error condition if imageStep is less than pRoiSize.width * <pixelSize>.
ippStsNotEvenStepErr	Indicates an error condition if steps for floating-point images are not divisible by 4, or steps for 16-bit integer images are not divisible by 2.
ippStsOutOfRangeErr	Indicates an error condition if the seed point is out of ROI.