Visible to Intel only — GUID: GUID-D2E822E1-492A-48F7-B108-F48B87E0F4D0
Visible to Intel only — GUID: GUID-D2E822E1-492A-48F7-B108-F48B87E0F4D0
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. |