Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
A newer version of this document is available. Customers should click here to go to the newest version.
GetPyramidDownROI
Computes the size of the lower pyramid layer.
Syntax
IppStatus ippiGetPyramidDownROI(IppiSize srcRoi, IppiSize* pDstRoi, Ipp32f rate);
Platform-aware functions
IppStatus ippiGetPyramidDownROI_L(IppiSizeL srcRoi, IppiSizeL *pDstRoi, Ipp32f rate);
Include Files
ippcv.h
Flavors with the _L suffix: ippcv_l.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h, ippi.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib
Parameters
- srcRoiSize
- Size of the source pyramid layer ROI in pixels.
- pDstRoiSize
- Pointer to the size of the destination (lower) pyramid layer ROI in pixels.
- rate
- Ratio between source and destination layers (1 < rate≤ 10).
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function computes the size of the lower pyramid layer pDstRoiSize for a source layer of a given size srcRoiSize and specified size ratio rate between them in accordance with the following formulas:

Since for the non-integer rate results depend on the computational precision, it is strongly recommended to use this function in computations.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error if pDstRoiSize pointer is NULL. |
ippStsSizeErr |
Indicates an error condition if srcRoiSize has a field with zero or negative value. |
ippStsBadArgErr |
Indicates an error condition if rate is out of the range. |