Performs 1:2 horizontal sampling and 1:1 vertical sampling of an image.
Syntax
IppStatus ippiSampleUpH2V1_JPEG_8u_C1R(const Ipp8u* pSrc, int srcStep, IppiSize srcSize, Ipp8u* pDst, int dstStep, IppiSize dstSize);
Parameters
pSrc |
Pointer to the source image ROI. |
srcStep |
Distance in bytes between starts of consecutive lines in the source image. |
srcSize |
Size of the source ROI in pixels. |
pDst |
Pointer to the destination image ROI. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image. |
dstSize |
Size of the destination ROI in pixels. |
Description
The function ippiSampleUpH2V1_JPEG is declared in the ippj.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function performs 1:2 horizontal sampling and 1:1 vertical sampling of an image. Sampling is performed following the scheme of a “triangle” filter as shown in Figure “Triangle Sampling Scheme”:
Here thick red lines denote source sample weight ¾ and thin blue lines denote source sample weight ¼ in their contribution to the destination sample value.
Note
This function requires that some samples outside the source image ROI are defined. Specifically, the left-most column must be present and the right-most column may be required.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error condition if one or both of the specified pointers are NULL. |
ippStsSizeErr |
Indicates an error condition if roiSize has a field with zero or negative value. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep has a zero or negative value |