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

MaxEvery

Computes maximum value for each pair of pixels of two images.

Syntax

Case 1: Not-in-place operation

IppStatus ippiMaxEvery_8u_C1R(const Ipp8u* pSrc1, int src1Step, const Ipp8u* pSrc2, int src2Step, Ipp8u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiMaxEvery_16u_C1R(const Ipp16u* pSrc1, int src1Step, const Ipp16u* pSrc2, int src2Step, Ipp16u* pDst, int dstStep, IppiSize roiSize);

IppStatus ippiMaxEvery_32f_C1R(const Ipp32f* pSrc1, int src1Step, const Ipp32f* pSrc2, int src2Step, Ipp32f* pDst, int dstStep, IppiSize roiSize);

Case 2: In-place operation

IppStatus ippiMaxEvery_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize);

Supported values for mod:

8u_C1IR

16u_C1IR

16s_C1IR

32f_C1IR

8u_C3IR

16u_C3IR

16s_C3IR

32f_C3IR

8u_C4IR

16u_C4IR

16s_C4IR

32f_C4IR

8u_AC4IR

16u_AC4IR

16s_AC4IR

32f_AC4IR

Include Files

ippi.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

pSrc1, pSrc2

Pointer to the first and second source image, respectively (for not-in-place operation).

src1Step, src2Step

Distance, in bytes, between the starting points of consecutive lines in the first and second source image, respectively (for not-in-place operation).

pDst

Pointer to the destination image (for not-in-place operation).

pSrc

Pointer to the first source image ROI (for in-place operation).

srcStep

Distance, in bytes, between the starting points of consecutive lines in the first source image (for in-place operation).

dstStep

Distance, in bytes, between the starting points of consecutive lines in the destination image.

pSrcDst

Pointer to the second source and destination image ROI (for in-place operation).

srcDstStep

Distance, in bytes, between the starting points of consecutive lines in the second source and destination image (for in-place operation).

roiSize

Size of the image ROI in pixels.

Description

This function operates with ROI (seeRegions of Interest in Intel IPP).

Not-in-place operation:

This function computes the maximum value for each pair of the corresponding pixels of two source images (pSrc1 and pSrc2 for not-in-place operation or pSrc and pSrcDst for in-place), and stores the result in pDst.

In-place operation:

This function computes the maximum value for each pair of the corresponding pixels of two source images pSrc and pSrcDst, and stores the result in pSrcDst:

pSrcDst(i, j) = max(pSrc( i,j), pSrcDst(i, j)).

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or a warning.

ippStsNullPtrErr

Indicates an error condition if one 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 if srcStep, src1Step, src2Step or srcDstStep is less than roiSize.width*<pixelSize>.

ippStsNotEvenStepErr

Indicates an error condition if one of step values for floating-point images are not divisible by 4.