MulScale
Multiplies pixel values of two images and scales the
products.
Syntax
Case 1: Not-in-place operation
IppStatus ippiMulScale_<mod>
(
const Ipp<datatype>*
pSrc1
,
int
src1Step
,
const Ipp<datatype>*
pSrc2
,
int
src2Step
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
);
Supported values for
mod
:8u_C1R | 16u_C1R |
8u_C3R | 16u_C3R |
8u_C4R | 16u_C4R |
8u_AC4R | 16u_AC4R |
Case 2: In-place operation
IppStatus ippiMulScale_<mod>
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
Ipp<datatype>*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
);
Supported values for
mod
:8u_C1IR | 16u_C1IR |
8u_C3IR | 16u_C3IR |
8u_C4IR | 16u_C4IR |
8u_AC4IR | 16u_AC4IR |
Include Files
ippi.h
Domain Dependencies
Headers:
ippcore.h
, ippvm.h
, ipps.h
Libraries:
ippcore.lib
, ippvm.lib
, ipps.lib
Parameters
- pSrc,pSrc1,pSrc2
- Pointers to the source images ROI.
- srcStep,src1Step,src2Step
- Distances in bytes between starts of consecutive lines in the source images.
- pDst
- Pointer to the destination image ROI.
- dstStep
- Distance in bytes between starts of consecutive lines in the destination image.
- pSrcDst
- Pointer to the source and destination image ROI for the in-place operation.
- srcDstStep
- Distance in bytes between starts of consecutive lines in the source and destination image for the in-place operation.
- roiSize
- Size of the source and destination ROI in pixels.
Description
This function operates with ROI (see Regions of Regions of Interest in Intel
IPP).
This function multiplies corresponding pixel values of two input
buffers and scales the products using the following formula:
dst_pixel
= src1_pixel
* src2_pixel
/ max_val
,where
src1_pixel
and src2_pixel
are pixel values of the source buffers, dst_pixel
is the resultant
pixel value, and max_val
is the maximum value of the pixel data range (see Table “Image
Data Types and Ranges”
for details). The function is implemented
for 8-bit and 16-bit unsigned data types only.Note that the functions with
AC4
descriptor do not process alpha channelss.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error condition if any of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with zero or negative value.
- ippStsStepErr
- Indicates an error condition if any of the specified buffer step values is zero or negative.