Intel® Integrated Performance Primitives Developer Guide and Reference

ID 790148
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Norm_Inf

Computes the infinity norm of image pixel values.

Syntax

Case 1: Operation on one-channel data

IppStatus ippiNorm_Inf_<mod>(const Ipp<datatype>* pSrc, int srcStep, 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 ippiNorm_Inf_<mod>(const Ipp<datatype>* pSrc, int srcStep, 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 ippiNorm_Inf_<mod>(const Ipp<datatype>* pSrc, int srcStep, IppiSize roiSize, Ipp64f value[3]);

Supported values for mod:

8u_C3R

16u_C3R

16s_C3R

32f_C3R

IppStatus ippiNorm_Inf_<mod>(const Ipp<datatype>* pSrc, int srcStep, 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 ippiNorm_Inf_<mod>(const Ipp<datatype>* pSrc, int srcStep, 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

pSrc

Pointer to the source image ROI.

srcStep

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

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.

coi

Channel of interest (for color images only); can be 1, 2, or 3.

pValue

Pointer to the computed infinity norm of pixel values.

value

An array containing the computed infinity norms of channel values in case of multi-channel data.

pNorm

Pointer to the computed norm value in the mask mode.

Description

The flavors of the function ippiNorm_Inf that perform masked operation are declared in the ippcv.h file. All other function flavors are declared in the ippi.h file. This function operates with ROI (see Regions of Interest in Intel IPP) and computes the infinity norm pValue (pNorm for the mask mode) for the source image pSrc. This norm is defined as the largest absolute pixel value in an image. In the mask mode, the computation is done over pixels selected by non-zero mask values.

For non-masked operations on a multi-channel image (Case 3), the norm is computed separately for each channel and stored in the array value .

In the mask multi-channel mode (Case 4), the 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 is NULL.

ippStsSizeErr

Indicates an error condition if roiSize has a field with zero or negative value.

ippStsStepErr

Indicates an error condition in mask mode, if srcStep or maskStep is less than roiSize.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 when coi is not 1, 2, or 3.