Reduces the image size using the super sampling method.
Syntax
Case 1: Operation on pixel-order data
IppStatus ippiSuperSampling_<mod>(const Ipp<datatype>* pSrc, int srcStep, IppiSize srcRoiSize, Ipp<datatype>* pDst, int dstStep, IppiSize dstRoiSize, Ipp8u* pBuffer);
Supported values for mod:
8u_C1R |
16u_C1R |
32f_C1R |
8u_C3R |
16u_C3R |
32f_C3R |
8u_C4R |
16u_C4R |
32f_C4R |
8u_AC4R |
16u_AC4R |
32f_AC4R |
Case 2: Operation on planar-order data
IppStatus ippiSuperSampling_<mod>(const Ipp<datatype>* const pSrc[3], int srcStep, IppiSize srcRoiSize, Ipp<datatype>* const pDst[3], int dstStep, IppiSize dstRoiSize, Ipp8u* pBuffer);
Supported values for mod:
8u_P3R |
16u_P3R |
32f_P3R |
IppStatus ippiSuperSampling_<mod>(const Ipp<datatype>* const pSrc[4], int srcStep, IppiSize srcRoiSize, Ipp<datatype>* const pDst[4], int dstStep, IppiSize dstRoiSize, Ipp8u* pBuffer);
Supported values for mod:
8u_P4R |
16u_P4R |
32f_P4R |
Parameters
pSrc |
Pointer to the source image ROI. An array of pointers to separate ROIs in each plane for planar image. |
srcStep |
Distance in bytes between starts of consecutive lines in the source image buffer. |
srcRoiSize |
Size of the source image ROI in pixels. |
pDst |
Pointer to the destination image ROI. An array of pointers to separate ROIs in each plane for planar image. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image buffer. |
dstRoiSize |
Size of the destination image ROI in pixels. |
pBuffer |
Pointer to the external buffer. |
Description
The function ippiSuperSampling is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function reduces the source image pSrc using the super sampling interpolation. The size of the external buffer must be calculated using the functions ippiSuperSamplingGetBufSize beforehand.
Use this function for video processing, in which it demonstrates good quality and performance.
Note
Performance is better if you use the following scaling factors along the x and y axes: 1/2, 2/3, 3/4, 4/5, 5/6, 8/9, 1/3, 2/5, 3/5, 3/7, 4/9, 7/10, 1/4, 2/7, 3/8, 1/8.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error condition if one of the specified pointer is NULL. |
ippStsSizeErr |
Indicates an error condition if srcRoiSize or dstRoiSize has a field with zero or negative value, or if dstRoiSize has a field that is greater than the appropriate field of the srcRoiSize. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep is less than or equal to 0. |