FilterDenoiseCAST

Performs content adaptive spatio-temporal noise reduction filtering.

Syntax

IppStatus ippiFilterDenoiseCAST_8u_C1R(const Ipp8u* pSrcCur, const Ipp8u* pSrcPrev, Ipp32s srcStep, const Ipp8u* pSrcEdge, Ipp32s srcEdgeStep, IppiSize srcRoiSize, Ipp8u* pDst, Ipp32s dstStep, Ipp8u* pHistoryWeight, IppiDenoiseCAST* pParam);

IppStatus ippiFilterDenoiseCASTYUV422_8u_C2R(const Ipp8u* pSrcCur, const Ipp8u* pSrcPrev, Ipp32s srcStep, const Ipp8u* pSrcEdge, Ipp32s srcEdgeStep, IppiSize srcRoiSize, Ipp8u* pDst, Ipp32s dstStep, Ipp8u* pHistoryWeight, IppiDenoiseCAST* pParam);

Parameters

pSrcCur

Pointer to the current source image frame.

pSrcPrev

Pointer to the previous processed image frame; can be NULL (see Description below).

srcStep

Distance in bytes between starts of the consecutive lines in the source image.

pSrcEdge

Pointer to the edge-detection filtered source image frame.

srcEdgeStep

Distance in bytes between starts of the consecutive lines in the edge-detection filtered source image frame.

pDst

Pointer to the destination image frame.

dstStep

Distance in bytes between starts of the consecutive lines in the destination image.

srcRoiSize

Size of the source and destination ROI.

pHistoryWeight

Pointer to the array of per-block history weights. Values correspond to blocks in raster order and are modified by the function. If pHistoryWeight == NULL, HistoryWeight from the structure pointed to by pParam, or the default value, is used for all blocks instead.

pParam

Pointer to the structure containing input parameters. If pParam == NULL, the default parameters are used.

Description

The functions ippiFilterDenoiseCAST_8u_C1R and ippiFilterDenoiseCASTYUV422_8u_C2R are declared in the ippvc.h file. The functions perform content adaptive spatio-temporal (CAST) noise reduction filtering for the packed YUY2 format (ippiFilterDenoiseCASTYUV422_8u_C2R) and for any planar format (ippiFilterDenoiseCAST_8u_C1R).

When called with pSrcPrev == NULL (no previous frame available), the functions perform spatial denoising only. In this case, the values pointed to by pHistoryWeight are not used but updated (if pHistoryWeight != NULL) by the function.

If the first call of the function is performed with pSrcPrev != NULL and pHistoryWeight != NULL, the user should fill the array with desired initial values.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error.

ippStsNullPtrErr

Indicates an error condition when the pSrcCur or pSrcEdge pointers are NULL.

ippStsSizeErr

Indicates an incorrect input size of the image, that is, srcRoiSize has a field with zero or negative value or, in the case of ippiFilterDenoiseCASTYUV422_8u_C2R, srcRoiSize.width is odd.


Submit feedback on this help topic

Copyright © 2000 - 2010, Intel Corporation. All rights reserved.