Creates an upper pyramid layer.
Syntax
IppStatus ippiPyramidLayerUp_<mod>(const Ipp<datatype>* pSrc, int srcStep, IppiSize srcRoiSize, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, IppiPyramidUpState_<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 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 destination image ROI in pixels.
- pState
- The pointer to the pyramid layer structure.
Description
The function ippiPyramidLayerUp is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function creates an upper pyramid layer pDst from the source image pSrc , that is, it performs upsampling of the source image and then applies the convolution kernel using the mirror border. Before calling ippiPyramidLayerUp function, the pyramid layer structure pState should be initialized by calling the function ippiPyramidLayerUpInitAlloc and the kernel and the upsampling ratio should be specified beforehand. The function can process images with srcRoiSize not greater than srcRoiSize parameter specified in the function ippiPyramidLayerUpInitAlloc.
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. |