Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
WarpPerspectiveGetSize
Computes the size of the specification structure and the size of the external work buffer for the warp perspective transform.
Syntax
IppStatus ippiWarpPerspectiveGetSize(IppiSize srcSize, IppiRect srcRoi, IppiSize dstSize, IppDataType dataType, const double coeffs[3][3], IppiInterpolationType interpolation, IppiWarpDirection direction, IppiBorderType borderType, int* pSpecSize, int* pInitBufSize);
Include Files
ippi.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib
Parameters
srcSize |
Size of the source image, in pixels. |
srcRoi |
Source image ROI (of the IppiRect type). Set this parameter to ippRectInfinite to use the entire source image extended by outer pixels according to the border type. |
dstSize |
Size of the destination image, in pixels. |
dataType |
Data type of the source and destination images. Supported values: ipp8u, ipp16u, ipp16s, and ipp32f. |
coeffs |
Coefficients for the perspective transform. |
interpolation |
Interpolation method. Supported values: ippNearest, ippLinear, and ippCubic. |
direction |
Transformation direction. Supported values:
|
borderType |
Type of border. Supported values:
|
pSpecSize |
Pointer to the size, in bytes, of the specification structure. |
pInitBufSize |
Pointer to the size, in bytes, of the temporary buffer. |
Description
This function computes the size of the specification structure and the external work buffer for the following functions, depending on the interpolation parameter: ippiWarpPerspectiveNearestInit, ippiWarpPerspectiveLinearInit, or ippiWarpPerspectiveCubicInit.
You can set the value of the srcRoi parameter to ippRectInfinite, which means that the ROI is not specified.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |
ippStsSizeErr |
|
ippStsRectErr |
|
ippStsDataTypeErr |
Indicates an error when dataType has an illegal value. |
ippStsWarpDirectionErr |
Indicates an error when direction has an illegal value. |
ippStsInterpolationErr |
Indicates an error when interpolation has an illegal value. |
ippStsCoeffErr |
Indicates an error when perspective transformation is singular. |
ippStsWrongIntersectQuad |
Indicates a warning that no operation is performed if the transformed source image extended with borders has no intersection with the destination image. |
ippStsBorderErr |
Indicates an error when borderType has an illegal value. |
ippStsSizeWrn |
Indicates a warning when srcRoi exceeds the source image. |
See Also
WarpPerspectiveNearestInit Initializes the specification structure for image perspective warping with the nearest neighbor interpolation method.
WarpPerspectiveLinearInit Initializes the specification structure for image perspective warping with the linear interpolation method.
WarpPerspectiveCubicInit Initializes the specification structure for image perspective warping with the cubic interpolation method.