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

MinMaxIndx

Calculates minimum and maximum pixel values and their indexes in selected image rectangle.

Syntax

Case 1: Operation on one-channel data

IppStatus ippiMinMaxIndx_<mod>(const Ipp<datatype>* pSrc, int srcStep, IppiSize roiSize, Ipp32f* pMinVal, Ipp32f* pMaxVal, IppiPoint* pMinIndex, IppiPoint* pMaxIndex);

Supported values for mod:

8u_C1R

16u_C1R

32f_C1R

Case 2: Masked operation on one-channel data

IppStatus ippiMinMaxIndx_<mod>(const Ipp<datatype>* pSrc, int srcStep, const Ipp8u* pMask, int maskStep, IppiSize roiSize, Ipp32f* pMinVal, Ipp32f* pMaxVal, IppiPoint* pMinIndex, IppiPoint* pMaxIndex);

Supported values for mod:

8u_C1MR

16u_C1MR

32f_C1MR

Case 3: Operation on multi-channel data

IppStatus ippiMinMaxIndx_<mod>(const Ipp<datatype>* pSrc, int srcStep, IppiSize roiSize, int coi, Ipp32f* pMinVal, Ipp32f* pMaxVal, IppiPoint* pMinIndex, IppiPoint* pMaxIndex);

Supported values for mod:

8u_C3CR

16u_C3CR

32f_C3CR

Case 4: Masked operation on multi-channel data

IppStatus ippiMinMaxIndx_<mod>(const Ipp<datatype>* pSrc, int srcStep, const Ipp8u* pMask, int maskStep, IppiSize roiSize, int coi, Ipp32f* pMinVal, Ipp32f* pMaxVal, IppiPoint* pMinIndex, IppiPoint* pMaxIndex);

Supported values for mod:

8u_C3CMR

16u_C3CMR

32f_C3CMR

Include Files

ippcv.h

Domain Dependencies

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

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.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 image ROI in pixels.

coi

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

pMinVal

Pointer to the variable that returns the value of the minimum pixel.

pMaxVal

Pointer to the variable that returns the value of the maximum pixel.

pMinIndex

Pointer to the variable that returns the index of the minimum value found.

pMaxIndex

Pointer to the variable that returns the index of the maximum value found.

Description

This function operates with ROI (see Regions of Interest in Intel IPP). This function finds minimum and maximum pixel values and their indexes in an image ROI or in an arbitrary image region defined by nonzero mask values. If there are several minima and maxima in the selected area, the function returns the top leftmost positions. If the specified region in the mask mode is empty, that is, the mask image is filled with zeros, then the function returns {minIndex, maxIndex} = {0, 0}, minVal=maxVal= 0. If any of the parameters pMinVal, pMaxVal, pMinIndex,or pMaxIndex is not required, the zero pointer is to be passed to the corresponding parameter.

Return Values

ippStsNoErr

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

ippStsNullPtrErr

Indicates an error condition if pSrc or pMask pointer is NULL.

ippStsSizeErr

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

ippStsStepErr

Indicates an error for masked operations when srcStep or maskStep is less than roiSize.width * <pixelSize> .

ippStsNotEvenStepErr

Indicates an error when steps for floating-point images cannot be divided by 4.

ippStsCOIErr

Indicates an error when coi is not 1, 2, or 3.