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

ID 790148
Date 10/31/2024
Public
Document Table of Contents

PyramidLayerDownGetSize

Computes the size of the structure for creating a lower pyramid layer and the size of the temporary buffer.

Syntax

IppStatus ippiPyramidLayerDownGetSize_8u_C1R(IppiSize srcRoi, Ipp32f rate, int kerSize, int* pStateSize, int* pBufSize);

IppStatus ippiPyramidLayerDownGetSize_8u_C3R(IppiSize srcRoi, Ipp32f rate, int kerSize, int* pStateSize, int* pBufSize);

IppStatus ippiPyramidLayerDownGetSize_16u_C1R(IppiSize srcRoi, Ipp32f rate, int kerSize, int* pStateSize, int* pBufSize);

IppStatus ippiPyramidLayerDownGetSize_16u_C3R(IppiSize srcRoi, Ipp32f rate, int kerSize, int* pStateSize, int* pBufSize);

IppStatus ippiPyramidLayerDownGetSize_32f_C1R(IppiSize srcRoi, Ipp32f rate, int kerSize, int* pStateSize, int* pBufSize);

IppStatus ippiPyramidLayerDownGetSize_32f_C3R(IppiSize srcRoi, Ipp32f rate, int kerSize, int* pStateSize, int* pBufSize);

Platform-aware functions

IppStatus ippiPyramidLayerDownGetSize_32f_C1R_L(IppiSizeL srcRoi, Ipp32f rate, int kerSize, IppSizeL* pStateSize, IppSizeL* pBufSize);

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

srcRoi
Size of the source 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.
pBufSize
Pointer to the size of the external work buffer.

Description

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

This function computes the size of the pState structure to build a lower pyramid layer and the size of the temporary buffer, in bytes. This structure is used by the ippiPyramidLayerDown function and can be applied to process images with size not greater than srcRoi. 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