Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804