CopySubpix
CopySubpix
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
);
Include Files
ippcv.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
,
ippi.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
,
ippi.lib
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 thex-coordinate in the source image.
- dy
- Fractional part of they-coordinate in the source image.
- scaleFactor
- Scale factor (see Integer Result Scaling).
Description
This function 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 isNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with a zero or negative value.
- ippStsStepErr
- Indicates an error condition ifsrcStepordstStepis less than.roiSize.width*<pixelSize>
- ippStsNotEvenStepErr
- Indicates an error condition if one ofsrcStepordstStepis not divisible by 4 for floating point images, or by 2 for short integer images.