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 |
Parameters
- pSrc
- Pointer to the source image ROI.
- srcStep
- Distance in bytes between starts 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 starts of consecutive lines in the destination image.
- dstRoiSize
- Size of the destination image ROI in pixels.
- pState
- Pointer to the pyramid layer structure.
Description
The function ippiPyramidLayerDown is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function creates a lower pyramid layer pDst from the source image pSrc, that is, it applies the convolution kernel to the source image using the mirror border and then performs downsampling. Before calling ippiPyramidLayerDown, the pyramid layer structure pState should be initialized by calling the function ippiPyramidLayerDownInitAlloc and the kernel and the downsampling ratio should be specified beforehand. The function can process images with srcRoiSize not greater than srcRoiSize parameter specified in the function ippiPyramidLayerDownInitAlloc.
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. |