Computes the size of the upper pyramid layer.
Syntax
IppStatus ippiGetPyramidUpROI(IppiSize srcRoiSize, IppiSize* pDstRoiSizeMin, IppiSize* pDstRoiSizeMax, Ipp32f rate);
Parameters
- srcRoiSize
- Size of the source pyramid layer ROI in pixels.
- pDstRoiSizeMin
- Pointer to the minimal size of the destination (upper) pyramid layer ROI in pixels.
- pDstRoiSizeMax
- Pointer to the maximal size of the destination (upper) pyramid layer ROI in pixels.
- rate
- Ratio between source and destination layers (1 < rate ≤ 10).
Description
The function ippiGetPyramidUpROI is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function computes possible sizes of the upper pyramid layer pDstRoiSizeMin and pDstRoiSizeMax for a source layer of a given size srcRoiSize and specified size ratio rate between them in accordance with the following formulas:
maximum size pDstRoiSizeMax: 
minimum size pDstRoiSizeMin:
if the width and height of the source layer ROI is greater
than 1,
if the width and height of the source layer ROI is equal
to 1,
Note
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 one of the specified pointers 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. |