AddWeighted
Adds weighted pixel values of a source image to floating-point pixel values of an accumulator image.
Syntax
Case 1: In-place operation
IppStatus ippiAddWeighted_<mod>
(
const Ipp<srcDatatype>*
pSrc
,
int
srcStep
,
Ipp32f*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
,
Ipp32f
alpha
);
Supported values for
mod
:
8u32f_C1IR |
16u32f_C1IR |
32f_C1IR |
Case 2: Masked in-place operation
IppStatus ippiAddWeighted_<mod>
(
const Ipp<srcDatatype>*
pSrc
,
int
srcStep
,
const Ipp8u*
pMask
,
int
maskStep
,
Ipp32f*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
,
Ipp32f
alpha
);
Supported values for
mod
:
8u32f_C1IMR |
16u32f_C1IMR |
32f_C1IMR |
Case 3: Not-in-place operation
IppStatus ippiAddWeighted_32f_C1R
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
Ipp32f*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
Ipp32f
alpha
);
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
- pSrc
- Pointer to the source image ROI for the in-place operation.
- pSrc1,pSrc2
- Pointers to the ROI in the source images.
- srcStep
- Distance in bytes between starts of consecutive lines in the source image for the in-place operation.
- src1Step,src2Step
- Distance in bytes between starts of consecutive lines in the source images.
- pMask
- Pointer to the mask image.
- maskStep
- Distance in bytes between starts of consecutive lines in the mask image.
- pSrcDst
- Pointer to the destination (accumulator) image ROI for the in-place operation.
- srcDstStep
- Distance in bytes between starts of consecutive lines in the accumulator 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 image ROI in pixels.
- alpha
- Weight a of the source image.
Description
This function operates with ROI (see
Regions of Interest in Intel IPP
).
This function adds pixel values of the source image
) and stores result in the
pSrc1
multiplied by a weight factor
alpha
to pixel values of the image
pSrc2
multiplied by (1-
alpha
pDst
as follows:
pDst
(x,y) =
pSrc1
(x,y)*
alpha
+
pSrc2
(x,y)*(1-
alpha
)
.
The in-place flavors of the function adds pixel values of the source image
pSrc
multiplied by a weight factor
alpha
to floating-point pixel values of the accumulator image
pSrcDst
multiplied by (1-
alpha
) as follows:
pSrcDst
(x,y) =
pSrcDst
(x,y)* (1-
alpha
) +
pSrc
(x,y)*
alpha
Addition of the weighted pixel values in case of a masked operation is performed only if the respective mask value is nonzero; otherwise, the accumulator pixel value remains unchanged.
Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error when any of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error whenroiSize.widthorroiSize.heightis equal to 0 or negative.
- ippStsStepErr
- Indicates an error when one of the step values is equal to zero, or is less thanroiSize.width * <pixelSize>.
- ippStsNotEvenStepErr
- Indicates an error when one of step values for floating-point images cannot be divided by 4.