InpaintInit
Initializes the state structure for image inpainting.
Syntax
IppStatus ippiInpaintInit_8u_C1R(IppiInpaintState_8u_C1R**
ppState
, const Ipp32f*
pDist
, int
distStep
, const Ipp8u*
pMask
, int
maskStep
, IppiSize
roiSize
, Ipp32f
radius
, IppiInpaintFlag
flags
, Ipp8u*
pStateBuf
, Ipp8u*
pBuf
);
IppStatus ippiInpaintInit_8u_C3R(IppiInpaintState_8u_C3R**
ppState
, const Ipp32f*
pDist
, int
distStep
, const Ipp8u*
pMask
, int
maskStep
, IppiSize
roiSize
, Ipp32f
radius
, IppiInpaintFlag
flags
, Ipp8u*
pStateBuf
, Ipp8u*
pBuf
);
Include Files
ippcv.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
,
ippi.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
,
ippi.lib
Parameters
- ppState
- Double pointer to the state structure for image inpaiting.
- pDist
- Pointer to the ROI of the image of distances.
- distStep
- Distance, in bytes, between the starting points of consecutive lines in the image of distances.
- pMask
- Pointer to the mask image ROI.
- maskStep
- Distance, in bytes, between the starting points of consecutive lines in the mask image.
- roiSize
- Size of the image ROI, in pixels.
- radius
- Radius of the neghborhood used for inpainting (dist≤radiuspixels are processed).
- flags
- Specifies algorithm for image inpainting. Possible values:
- IPP_INPAINT_TELEA
- Telea algorithm
- IPP_INPAINT_NS
- Navier-Stokes equation
- pStateBuf
- Pointer to the buffer for the state structure initialization.
- pBuf
- Pointer to the external work buffer.
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function initializes the
ppState
structure for direct methods of image inpainting. This structure is used by the ippiInpaint
function and can be applied to process images of the same size roiSize
.Zero pixels of the
pMask
image correspond to the known image pixels, non-zero pixels - to the unknown image pixels that should be restored. The distance image pDist
specifies the order of pixel inpainting. Values of unknown pixels are restored in ascending order depending on their distances. The radius
parameter specifies the radius of the circular neighborhood that affects the restoration of the central pixel. The flag
parameter specifies the method of direct inpainting. Two methods are supported: Telea algorithm [Telea04] and Navier-Stokes equation [Bert01].For an example on how to use this function, refer to the example provided with the
ippiInpaint
function description.The image ROI must not exceed the maximum width and height of
roiSize
specified in the initialization function.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error when one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error when width or height of the image is less than, or equal to zero.
- ippStsStepErr
- Indicates an error when the step of the mask or distance image ROI is too small.
- ippStsNotEvenStepErr
- Indicates an error when the step value is not divisible by thepDistelement.
- ippStsBadArgErr
- Indicates an error whenradiusis less than 1, orflagshas an illegal value.