NormRel_Inf
Computes the relative error for the infinity norm of differences between pixel values of two images.
Syntax
Case 1: Operation on one-channel data
IppStatus ippiNormRel_Inf_<mod>(const Ipp<datatype>*
pSrc1
, int
src1Step
, const Ipp<datatype>*
pSrc2
, int
src2Step
, IppiSize
roiSize
, Ipp64f*
pValue
);
Supported values for
mod
:8u_C1R | 16u_C1R | 16s_C1R | 32f_C1R |
Case 2: Masked operation on one-channel data
IppStatus ippiNormRel_Inf_<mod>(const Ipp<datatype>*
pSrc1
, int
src1Step
, const Ipp<datatype>*
pSrc2
, int
src2Step
, const Ipp8u*
pMask
, int
maskStep
, IppiSize
roiSize
, Ipp64f*
pNorm
);
Supported values for
mod
:8u_C1MR | 16u_C1MR | 32f_C1MR |
Case 3: Operation on multi-channel data
IppStatus ippiNormRel_Inf_<mod>(const Ipp<datatype>*
pSrc1
, int
src1Step
, const Ipp<datatype>*
pSrc2
, int
src2Step
, IppiSize
roiSize
, Ipp64f
value[3]
);
Supported values for
mod
:8u_C3R | 16u_C3R | 16s_C3R | 32f_C3R |
IppStatus ippiNormRel_Inf_<mod>(const Ipp<datatype>*
pSrc1
, int
src1Step
, const Ipp<datatype>*
pSrc2
, int
src2Step
, IppiSize
roiSize
, Ipp64f
value[4]
);
Supported values for
mod
:8u_C4R | 16u_C4R | 16s_C4R | 32f_C4R |
Case 4: Masked operation on multi-channel data
IppStatus ippiNormRel_Inf_<mod>(const Ipp<datatype>*
pSrc1
, int
src1Step
, const Ipp<datatype>*
pSrc2
, int
src2Step
, const Ipp8u*
pMask
, int
maskStep
, IppiSize
roiSize
, int
coi
, Ipp64f*
pNorm
);
Supported values for
mod
:8u_C3CMR | 16u_C3CMR | 32f_C3CMR |
Include Files
ippcv.h
ippi.h
Domain Dependencies
Flavors declared in
ippcv.h
:Headers:
ippcore.h
,
ippvm.h
,
ipps.h
,
ippi.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
,
ippi.lib
Flavors declared in
ippi.h
:Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
- pSrc1, pSrc2
- Pointers to the source images ROI.
- 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.
- roiSize
- Size of the source ROI in pixels.
- pValue
- Pointer to the computed relative error value.
- value
- An array containing the computed relative error values for separate channels in case of multi-channel data.
- coi
- Channel of interest (for color images only); can be 1, 2, or 3.
- pNorm
- Pointer to the computed relative norm value in the mask mode.
Description
The flavors of the function
ippiNormRel_Inf
that perform masked operation are declared in the ippcv.h
file. All other function flavors are declared in the ippi.h
file. The function operates with ROI (see Regions of Interest in Intel IPP). It computes the infinity norm of differences between pixel values of two source buffers pSrc1
and pSrc2.
This norm is defined as the largest absolute pixel value in an image. The output relative error pValue
(pNorm
in the mask mode) is then formed by dividing the computed norm of differences by the infinity norm of the second source image buffer pSrc2.
In the mask mode, the computation is done over pixels selected by nonzero mask values.For non-masked operations on multi-channel images (Case 3), the relative norm is computed separately for each pair of corresponding channels and stored in the array
value
.In the mask multi-channel mode (
Case 4
), the relative norm is computed for a single channel of interest specified by coi
.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error when any of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with zero or negative value.
- ippStsStepErr
- Indicates an error condition in mask mode, ifsrc1Step,src2Step, ormaskStepis less thanroiSize.width * <pixelSize>.
- ippStsNotEvenStepErr
- Indicates an error condition in mask mode if steps for floating-point images cannot be divided by 4.
- ippStsCOIErr
- Indicates an error whencoiis not 1, 2, or 3.
- ippStsDivByZero
- Indicates a warning when the infinity norm ofpSrc2has a zero value.