Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public
Document Table of Contents

PyramidLayerUpGetSize

Computes the size of the structure for creating an upper pyramid layer and the size of the temporary buffer.

Syntax

IppStatus ippiPyramidLayerUpGetSize_8u_C1R(IppiSize dstRoi, Ipp32f rate, int kerSize, int* pStateSize);

IppStatus ippiPyramidLayerUpGetSize_8u_C3R(IppiSize dstRoi, Ipp32f rate, int kerSize, int* pStateSize);

IppStatus ippiPyramidLayerUpGetSize_16u_C1R(IppiSize dstRoi, Ipp32f rate, int kerSize, int* pStateSize);

IppStatus ippiPyramidLayerUpGetSize_16u_C3R(IppiSize dstRoi, Ipp32f rate, int kerSize, int* pStateSize);

IppStatus ippiPyramidLayerUpGetSize_32f_C1R(IppiSize dstRoi, Ipp32f rate, int kerSize, int* pStateSize);

IppStatus ippiPyramidLayerUpGetSize_32f_C3R(IppiSize dstRoi, Ipp32f rate, int kerSize, int* pStateSize);

Platform-aware functions

IppStatus ippiPyramidLayerUpGetSize_32f_C1R_L(IppiSizeL dstRoi, Ipp32f rate, int kerSize, IppSizeL* pStateSize);

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

dstRoi
Size of the destination image ROI.
rate
Ratio between neighbouring levels (1 < rate 10).
kerSize
Size of the kernel.
pStateSize
Pointer to the size of the pyramid layer state structure.

Description

This function operates with ROI (see Regions of Interest in Intel IPP).

This function computes the size of the pState structure to build an upper pyramid layer and the size of the temporary buffer, in bytes. This structure is used by the ippiPyramidLayerUp function and can be applied to process images with size not greater than dstRoi. For an example on how to use this function, refer to the example provided with the ippiPyramidLayerDown function description.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when at least one of the pointers is NULL.

ippStsSizeErr

Indicates an error when the width or height of images is less than, or equal to zero.

ippStsBadArgErr

Indicates an error when kerSize is even, or equal to or less than 0; or when rate is out of the range.

See Also