Visible to Intel only — GUID: GUID-F1479F22-02FB-47F3-B227-23E007233F86
Visible to Intel only — GUID: GUID-F1479F22-02FB-47F3-B227-23E007233F86
GetPyramidUpROI
Computes the size of the upper pyramid layer.
Syntax
IppStatus ippiGetPyramidUpROI(IppiSize srcRoi, IppiSize* pDstRoiMin, IppiSize* pDstRoiMax, Ipp32f rate);
Platform-aware functions
IppStatus ippiGetPyramidUpROI_L(IppiSizeL srcRoi, IppiSizeL *pDstRoiMin, IppiSizeL *pDstRoiMax, 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.
- 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
This function 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:
![](/content/dam/docs/us/en/developer-guide-reference/2021-12/A1EC661A-E518-4F67-B864-007A0F7CD395-low.jpg)
minimum size pDstRoiSizeMin:
if the width and height of the source layer ROI is greater than 1,
![](/content/dam/docs/us/en/developer-guide-reference/2021-12/E1214F24-D4F8-4BAC-8C1A-58405338E99F-low.jpg)
if the width and height of the source layer ROI is equal to 1,
![](/content/dam/docs/us/en/developer-guide-reference/2021-12/85217BA9-5415-49D3-9DC4-4D8382636D5F-low.jpg)
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. |