Developer Reference for Intel® Integrated Performance Primitives 2019

PyramidLayerDown

Creates a lower pyramid layer.

Syntax

IppStatus ippiPyramidLayerDown_<mod>(const Ipp<datatype>* pSrc, int srcStep, IppiSize srcRoiSize, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiPyramidDownState_<mod>* pState);

Supported values for mod:

8u_C1R

16u_C1R

32f_C1R

8u_C3R

16u_C3R

32f_C3R

Include Files

ippcv.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h, ippi.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib

Parameters

pSrc
Pointer to the source image ROI.
srcStep
Distance, in bytes, between the starting points of consecutive lines in the source image.
srcRoiSize
Size of the source image ROI, in pixels.
pDst
Pointer to the destination image ROI.
dstStep
Distance, in bytes, between the starting points of consecutive lines in the destination image.
dstRoiSize
Size of the destination image ROI, in pixels.
pState
Pointer to the pyramid layer structure.

Description

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

This function creates a lower pyramid layer pDst from the source image pSrc. The function applies the convolution kernel to the source image using the mirror border and then performs downsampling. Before calling ippiPyramidLayerDown, compute the size of the pState structure and work buffer using the PyramidLayerDownGetSize function and initialize the structure using the PyramidLayerDownInit function. The function can process images with srcRoiSize not greater than the srcRoi parameter specified in the PyramidLayerDownInit function.

Note

This function uses the mirrored border.

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 or dstRoiSize has a field with zero or negative value.

ippStsStepErr

Indicates an error condition if srcStep is less than srcRoiSize.width * <pixelSize> , or dstStep is less than dstRoiSize.width * <pixelSize>.

ippStsNotEvenStepErr

Indicates an error condition if one of the step values is not divisible by 4 for floating-point images, or by 2 for short-integer images.

ippStsBadArgErr

Indicates an error condition if pState->rate has wrong value.

Example

PyramidLayerDown.c

See Also