Copies pixel values between two images with subpixel precision.
Syntax
Case 1: Copying without conversion or with conversion to floating point data
IppStatus ippiCopySubpix_<mod>(const Ipp<srcDatatype>* pSrc, int srcStep, Ipp<dstDatatype>* pDst, int dstStep, IppiSize roiSize, Ipp32f dx, Ipp32f dy);
Supported values for mod:
| 8u_C1R | 16u_C1R | 32f_C1R |
| 8u32f_C1R | 16u32f_C1R |
Case 2: Copying with conversion to integer data
IppStatus ippiCopySubpix_8u16u_C1R_Sfs(const Ipp8u* pSrc, int srcStep, Ipp16u* pDst, int dstStep, IppiSize roiSize, Ipp32f dx, Ipp32f dy, int scaleFactor);
Parameters
pSrc |
Pointer to the source image ROI. |
srcStep |
Distance in bytes between starts of consecutive lines in the source image. |
pDst |
Pointer to the destination image ROI. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image. |
roiSize |
Size of the source and destination ROI in pixels. |
dx |
Fractional part of the x-coordinate in the source image. |
dy |
Fractional part of the y-coordinate in the source image. |
scaleFactor |
Scale factor (see Integer Result Scaling). |
Description
The function ippiCopySubpix is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function computes the pixel value of the destination image using linear interpolation (see Linear Interpolation in Appendix B) in accordance with the following formula:
where i = 0, ... roiSize.height - 1 , j = 0, ... roiSize.width - 1 .
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error when any of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition if roiSize has a field with a zero or negative value. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep is less than roiSize.width * <pixelSize>. |
ippStsNotEvenStepErr |
Indicates an error condition if one of srcStep or dstStep is not divisible by 4 for floating point images, or by 2 for short integer images. |