Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
WarpPerspectiveNearestInit
Initializes the specification structure for image perspective warping with the nearest neighbor interpolation method.
Syntax
IppStatus ippiWarpPerspectiveNearestInit(IppiSize srcSize, IppiRect srcRoi, IppiSize dstSize, IppDataType dataType, const double coeffs[3][3], IppiWarpDirection direction, int numChannels, IppiBorderType borderType, const Ipp64f* pBorderValue, int smoothEdge, IppiWarpSpec* pSpec);
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. |
direction |
Transformation direction. Supported values: * ippWarpForward - forward transformation * ippWarpBackward - backward transformation |
numChannels |
Number of channels in the image. Supported values: 1, 3, or 4. |
borderType |
Type of border. Supported values: * ippBorderConst - values of all border pixels are set to a constant; * ippBorderRepl - border is replicated from the edge pixels; * ippBorderTransp - outer pixels are not processed; * ippBorderInMem - border is obtained from the source image pixels in memory. |
pBorderValue |
Pointer to the constant value to assign to pixels of the constant border. This parameter is applicable only to the ippBorderConst border type. |
smoothEdge |
|
pSpec |
Pointer to the specification structure. |
Description
This function initializes the IppiWarpSpec structure for the WarpPerspectiveNearest function that performs warp perspective transformation with the nearest neighbor interpolation method. To compute the size of the specification structure, use the WarpPerspectiveGetSize function.
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 |
|
ippStsSizeErr |
Indicates an error when width or height of the source or destination image is less than, or equal to one. |
ippStsRectErr |
|
ippStsDataTypeErr |
Indicates an error when dataType has an illegal value. |
ippStsWarpDirectionErr |
Indicates an error when direction 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. |
ippStsNotSupportedModeErr |
Indicates an error when the requested mode is not supported. The edge smoothing feature is not supported for the ippBorderRepl and ippBorderConst border types. |
ippStsBorderErr |
Indicates an error when borderType has an illegal value. |
ippStsNumChannelsErr |
Indicates an error when numChannels has an illegal value. |
ippStsSizeWrn |
Indicates a warning when srcRoi exceeds the source image. |
See Also
WarpPerspectiveGetSize Computes the size of the specification structure and the size of the external work buffer for the warp perspective transform.
WarpPerspectiveNearest Performs warp perspective transformation of an image using the nearest neighbor interpolation method.