Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 10/31/2024
Public
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.